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微服 务 一 词 相信 对 很 多 开发 者 来 说 已 经 耳熟能详 了 。 在 我 曾经 工作 的 公司 , 还 是 使 用 单 体 
项 目 来 部 署 时 , 无论 是 打包 还 是 运行 都 耗 时 耗 力 ， 这 一 直 让 我 很 苦恼 。 同时， 每 次 需要 创建 新 
应 用 、 构建 项 目 配置 Spring 的 时 候 也 十 分 麻烦 。 一 次 偶然 的 情况 , 我 接触 了 Spring Boot 框架 ， 
开始 对 其 “约定 优先 配置 ”的 特性 着 迷 了 。 这 个 由 Pivotal 团队 进行 维护 开发 的 Spring Boot， 
版 本 更 迭 非 常 快 , 社区 活跃 度 很 高 。 我 在 闲暇 之 余 查 阅 了 国内 很 多 招聘 网 站 , 原来 已 经 有 很 多 
公司 将 Spring Boot 作为 必 备 技能 。 
此 后 ， 我 花费 了 很 长 的 时 间 翻 看 技术 博客 、 官 方 文档 等 ， 深 入 学 习 Spring Boot 框架 。 在 
公司 接 下 来 的 项 目 中 ， 都 以 Spring Boot 为 主 来 构建 项 目 ， 并 且 成 功 地 将 很 多 使 用 Spring Boot 
的 项 目 投入 生产 ，Spring Boot 框架 的 快速 构建 与 部 署 与 公司 快速 迭代 版 本 的 风格 完美 呼应 。 
这 是 Spring Boot 值得 学 习 的 一 大 原因 。 
本 书 沿袭 我 学 习 Spring Boot 的 路 线 ， 使 用 Spring Boot 与 当今 常用 的 中 间 件 结合 ， 并 且 配 
备 对 应 的 实例 代码 。 最 后 的 两 章 项 目 实战 是 对 Spring Boot 的 学 习 之 路 做 出 总 结 ， 为 本 书画 上 
一 个 圆满 的 名 号。 希望 读 者 阅读 本 书后 能 够 有 所 收获 。 


如 何 阅 读本 书 


在 阅读 本 书 的 过 程 中 , 建议 对 照 源 代 码 按 顺 序 学 习 。 当 然 ， 如 果 对 部 分 章节 的 内 容 比较 熟 
悉 , 也 可 以 直接 跳 过 ,学 习 需 要 巩固 的 章节 。 本 书 内 容 共 分 为 14 章 ,开发 工具 使 用 IntelliJ IDEA, 
Spring Boot 版 本 为 2.0.3， 各 章节 内 容 说 明 如 下 : 


第 1 章 介绍 Spring Boot 框架 的 特点 以 及 学 习 它 的 重要 性 , 最 后 列 出 Spring Boot 的 历史 版 
本 ， 让 读者 对 Spring Boot 有 一 个 大 致 的 了 解 。 

第 2 章 介绍 如 何 搭建 Spring Boot 的 开发 环境 ， 通 过 使 用 IntelliJ IDEA 构建 Spring Boot 项 
目 ， 并 且 对 Spring Boot 项 目的 基础 结构 进行 介绍 。 

第 3 章 介绍 如 何 使 用 Spring Boot 开发 Web 应 用 ， 了 解 Spring MVC 和 Spring Web Flux 的 
不 同 ， 最 后 学 习 Spring Boot 的 一 些 Web 模板 框架 ， 让 读者 可 以 对 Spring Boot 开发 Web 应 用 
HIAR. 

第 4 章 和 第 5 章 都 是 基于 Spring Boot 对 数据 库 的 使 用 进行 学 习 。 其 中 , 第 4 章 从 Spring Boot 
使 用 各 种 数据 库 的 依赖 和 配置 开始 介绍 ， 然 后 介绍 当今 Java 语言 流行 的 ORM 框架 的 使 用 ， 
最 后 学 习 Spring Boot 使 用 Druid 数据 库 连 接 池 。 第 5 章 介 绍 Spring Boot 常用 缓存 框架 ， 最 后 
对 Redis 和 Memcached 进行 比较 ， 让 读者 选择 缓存 时 有 一 定 的 基础 。 

第 6 章 介绍 Spring Boot 对 几 种 常用 日 志 框架 的 使 用 ,最 后 介绍 分 布 式 情况 下 如 何 使 用 ELK 
进行 日 志 收集 。 

第 7 章 介绍 当今 比较 常用 的 两 种 安全 框架 ， 并 且 使 用 详细 的 案例 对 二 者 进行 运用 。 

第 8 章 介 绍 Spring Boot 如 何 进行 监控 ， 涉 及 当今 Spring Boot 框架 常用 的 监控 ,使 读者 对 
Spring Boot 的 运行 状态 更 加 了 解 。 
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第 9 章 介绍 Spring Boot 如 何 使 用 消息 队列 ， 分 别 从 RabbitMQ Kafka 和 RocketMQ 的 使 
用 实例 进行 介绍 ， 最 后 对 三 者 进行 比较 ， 让 读者 在 选择 消息 队列 时 有 一 定 的 借鉴 。 

第 10 章 对 Spring Boot 的 两 大 常用 搜索 框架 进行 详细 的 介绍 ， 从 普通 增 、 删 、 改 、 查 到 复 
杂 查 询 ， 让 读者 使 用 搜索 框架 时 不 再 茫然。 

第 11 章 介绍 使 用 Spring Boot 时 的 一 些小 技巧 ， 比 如 启动 Banner、Lombok、 邮 件 发 送 、 
事务 、 异 常 等 。 虽然 知 识 略 微 零 散 ， 但 是 都 是 实用 的 技巧 。 

第 12 章 介绍 Spring Boot 的 多 种 部 署 方式 ,让 读者 可 以 根据 实际 情况 部 署 自己 的 应 用 程序 。 

第 13 章 和 第 14 章 分 别 使 用 博客 系统 和 博客 后 台 系 统 对 Spring Boot 的 使 用 进行 综合 实战 ， 
这 两 个 实战 案例 是 对 本 书 内 容 的 总 结 。 


本 书 读者 对 象 


。 初学 者 
* Java 开发 人 员 
e 架构 师 
* Spring 爱好 者 
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源 代码 下 载 


本 书 所 有 源 代码 均 上 传 至 码 云 , 地 址 是 https://gitee.com/dalaoyang/springboot_book。 
如 果 下 载 有 问题 ， 请 发 送 电子 邮件 至 booksaga@126.com， 邮 件 主题 为 “ 求 Spring Boot 2 
实战 之 旅 下 载 资源 ”。 
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Spring Boot 概述 


本 章 将 对 Spring Boot 进行 整体 的 介绍 ,从 Spring Boot 的 特点 开始 ,逐步 让 大 家 了 解 学 习 Spring 
Boot 会 为 我 们 带 来 的 好 处 ， 最 后 从 Spring Boot 的 发 展 史 (Spring Boot 1.x 到 Spring Boot 2.x) 来 全 
面 概述 Spring Boot 微服 务 框架 的 多 功能 


1.1 Spring Boot 简介 


Spring Boot 是 由 Pivotal 团队 在 2014 年 发 布 的 全 新 框架 。 从 Spring Boot 的 Logo 中 可 以 看 到 ， 
Spring Boot 是 要 打造 一 个 快速 构建 的 Spring 应 用 ， 如 图 1-1 所 示 。 正 如 Spring 官网 (官网 地 址 : 
http://spring.io/) 介绍 的 : 

“Spring Boot is designed to get you up and running as quickly as possible, 


with minimal upfront configuration of Spring. Spring Boot takes an opinionated 
view of building production ready applications.” 


O Spring Boot 


图 1-1 Spring Boot 官方 Logo 图 片 


翻译 过 来 的 意思 大 概 是 : Spring Boot 的 设计 是 可 以 尽 可 能 快 地 启动 和 运行 ， 只 需要 最 少 的 
Spring 配置 。Spring Boot 对 构建 生产 就 绪 应 用 程序 具有 独特 的 方式 。 从 官方 的 介绍 可 以 看 出 Spring 
Boot 的 核心 思想 是 “约定 优先 于 配置 (Convention Over Configuration) ”， 其 本 质 其 实 还 是 基于 
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Spring 来 实现 的 。 对 于 了 解 Spring 的 人 或 者 使 用 过 Spring 的 人 来 说 ，Spring 烦琐 的 配置 让 很 多 程 
序 员 眼 花 综 乱 (各 种 XML. Annotation 配置 等 ) ， 甚 至 很 多 时 候 发 生 错误 也 很 难 快速 定位 错误 的 
地 方 。 而 在 Spring Boot 框架 中 ， 为 我 们 提供 了 默认 的 配置 ， 从 而 使 开发 人 员 不 再 需要 定义 样板 化 
的 配置 ， 通 过 这 种 方式 ，Spring Boot 致力 于 在 蓬勃 发 展 的 快速 应 用 开发 领域 (Rapid Application 
Development) 成 为 领导 者 。 


1.2 Spring Boot 的 特点 


Spring 团队 曾经 为 开发 者 提供 了 无 数 的 便利 ,其 提供 的 IOC 和 AOP 两 大 特性 一 直 为 广大 开发 
者 所 “ 深 爱 ”。 当 然 ，Spring 框架 还 提供 了 很 多 优秀 的 特性 ， 在 这 里 就 不 一 一 介绍 了 。 但 是 ， 在 传 
统 Spring 框架 中 有 一 个 重大 的 缺点 , 那 就 是 在 配置 的 时 候 很 复杂 , 需要 重复 地 进行 一 些 配 置 .Spring 
团队 可 能 感受 到 了 这 一 点 ， 在 2014 年 ，Spring 团队 发 布 了 Spring Boot 框架 。 另 外 ， 官 网 首页 的 


Spring Boot 部 分 也 介绍 了 诸多 Spring Boot 的 特点 ， 如 图 1-2 所 示 。 本 节 将 逐一 介绍 Spring Boot 框 


© Spring Boot 


BUILD ANYTHING WITH SPRING BOOT 


图 1-2 Spring Boot 官 网 简介 (图 片 来 源 于 Spring 官网 : http://spring.io/) 


1.2.1 快速 构建 项 目 


Spring Boot 具有 多 种 快速 构建 项 目的 方式 ， 如 下 面 几 种 形式 : 


(1) 使 用 Eclipse (MyEclipse) 可 以 利用 创建 Maven 项 目的 方式 创建 Spring Boot 项 目 。 当 然 ， 
如 果 在 Eclipse 中 安装 了 Spring Tools， 就 可 以 直接 创建 Spring Starter Project。 

(2) {$E Intellij IDEA， 可 以 利用 创建 Spring Initializr 的 方式 创建 Spring Boot 项 目 ， 在 后 续 
音节 会 详细 介绍 这 种 方式 的 过 程 。 

(3) 使 用 Spring Tool Suite， 可 以 直接 新 建 Spring Starter Project 项 目 ， 过 程 类 似 Eclipse 创建 
Spring Boot 项 目 。 
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(4) 使 用 官方 文档 创建 项 目 ， 在 Spring 官方 文档 上 面 提供 了 一 种 在 线 生成 Spring Boot 项 目 
的 方式 ， 首 先 访问 Spring 官方 快速 构建 地 址 (官网 地 址 : https:/start.spring.io/) ， 在 这 个 页 面 上 选 
择 对 应 版 本 、 构 建 工 具 等 , 填写 完成 后 单 击 Generate Project 按钮 , 即 可 在 本 地 下 载 一 个 Spring Boot 
项 目的 压缩 包 。 


当然 ， 可 能 还 有 很 多 方式 快速 构建 项 目 ， 这 里 就 不 一 一 介绍 了 。 笔 者 在 这 里 推荐 使 用 IntelliJ 
IDEA 开发 项 目 , 个 人 感觉 这 个 开发 工具 还 是 很 强大 的 ， 并 且 提 供 了 很 多 插件 供 开发 者 使 用 ， 读 者 
也 可 以 根据 自己 的 喜好 进行 选择 ， 毕 竞 适合 自己 的 才 是 最 好 的 。 


1.2.2 WAR Web 容器 


在 传统 Java Web 项 目 中 ， 当 项 目 开发 完成 之 后 ， 还 需要 配置 所 需 的 Web 容器 (诸如 Tomcat 
或 者 WebLogic 之 类 的 Web 容器 ) 。 但 是 在 Spring Boot 搭建 的 项 目 中 , 内 部 提供 了 几 种 Web 容器 ， 
如 Tomcat, Jetty 和 Undertow。 在 Spring Boot 1.x 中 默认 为 Tomcat: Spring Boot 2.x 中 则 分 为 两 种 
情况 ， 引 入 spring-boot-starter-web 依赖 为 Tomcat， 引 入 spring-boot-starter-webflux 依赖 则 为 Netty。 
当然 ， 也 支持 使 用 之 前 指出 的 几 种 Web 容器 ， 开 发 者 只 需要 根据 场景 选择 适合 的 Starter 来 获取 一 
个 默认 配置 好 的 容器 即 可 ， 当 启动 成 功 后 ， 应 用 一 个 默认 端口 为 8080 的 HTTP 服务 。 


1.2.3 “易于 构建 任何 应 用 


Spring Boot 提供 了 一 个 强大 的 starter 依赖 机 制 , 实质 上 Spring 团队 将 Spring Boot 框架 整合 
一 切 常用 的 maven 依赖 ， 使 Spring Boot 想 要 整合 对 应 依赖 ， 就 要 将 需要 的 依赖 全 部 引入 。 比 如 ， 
需要 在 项 目 中 使 用 Web， 也 就 是 我 们 常 说 的 Spring MVC， 如 果 是 原 有 的 maven 项 目 ， 就 需要 引入 
很 多 依赖 才能 完成 这 个 简单 的 需求 。 但 是 在 Spring Boot 项 目 中 ， 我 们 只 需要 在 maven 依赖 中 加 入 
spring-boot-starter-web 依赖 即 可 , 是 不 是 很 简单 ? 这 里 再 举 一 个 例子 , 比如 项 目 中 需要 使 用 MySQL 
数据 库 ， 这 里 只 需要 加 入 MySQL 依赖 ， 并 且 在 配置 文件 中 配置 数据 库 信息 就 可 以 正常 使 用 。 


124 自动 化 配置 


这 个 特点 是 上 一 个 特点 的 延伸 ， 在 应 用 程序 中 引入 依赖 之 后 ， 其 实 还 有 一 个 强大 之 处 在 于 
Spring Boot 应 用 会 根据 引入 的 依赖 提供 一 些 默认 的 配置 供 我 们 使 用 ， 如 果 需 要 修改 ， 那 么 只 需要 
在 配置 文件 中 修改 对 应 的 配置 即 可 完成 需求 。 这 里 还 是 以 Spring MVC 为 例 ， 传 统 Spring MVC 项 
目 需要 配置 对 应 的 诸如 ApplicationContext.xml (Spring 配置 文件 ) ApplicationContext-mvc.xml 

(Spring MVC 配置 文件 ) ， 而 在 Spring Boot 中 ， 这 些 需 要 的 配置 已 经 为 我 们 默认 配置 了 一 套 ， 不 
需要 再 进行 配置 了 .比如 , 我们 要 加 入 Web 应 用 程序 根 路 径 test 的 话 , 只 需要 在 application.properties 
(Spring Boot 应 用 程序 默认 配置 文件 ) 中 加 入 server.servlet.context-path=/test 即 可 。 
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125 ”开发 者 工具 


在 开发 Web 应 用 的 时 候 ， 总 会 有 一 个 困扰 我 们 的 问题 ， 修 改 代码 总 是 伴随 不 断 重启 项 目 ， 需 
要 不 断 地 断 开 Web 容器 ， 再 重启 来 测试 我 们 的 代码 。 在 Spring Boot 应 用 中 提供 了 开发 者 工具 
Cspring-boot-devtools) ， 当 我 们 重新 编译 类 文件 的 时 候 ， 开 发 者 工具 会 自动 蔡 我 们 重启 应 用 ， 无 
须 手 动 单 击 重启 。 


1.2.6 ”强大 的 应 用 监控 


在 生产 环境 中 ， 应 用 的 各 项 指标 监控 更 是 必 不 可 少 。 在 Spring Boot 应 用 中 提供 了 一 个 
spring-boot-starter-actuator (以 下 简称 Spring Boot-Actuator) 来 供 我 们 查看 应 用 的 各 项 指标 , 如 health 
(健康 检查 ) 、dump 活 动 线程 》、env 环 境 属 性 ) ~ metrics (内 存 ，CPU 等 ) 等 指标 ， 以 监控 
我 们 的 应 用 ， 同 时 可 以 配合 使 用 spring-boot-admin-starter-server (以 下 简称 Spring Boot-Admin) Wi 
控 我 们 的 项 目 。Spring Boot-Admin 可 以 在 利用 监控 Spring Boot-Actuator 端点 的 同时 监控 所 有 微服 
务 应 用 的 健康 状态 ， 如 果 出 现 异常 ， 就 可 以 向 维护 人 员 发 送 邮件 或 者 以 其 他 方式 给 予 告 警 。 不 只 是 
这 样 ， 就 连 监控 神器 Prometheus 也 可 以 通过 简单 的 配置 接 入 Spring Boot 应 用 程序 中 。 


1.2.7 默认 提供 测试 框架 


Spring Boot 应 用 在 创建 项 目 之 后 会 默认 为 我 们 创建 测试 类 的 文件 ， 实 质 上 就 是 引入 
spring-boot-starter-test 依赖 ， 然 后 可 以 通过 它 对 各 种 场景 进行 测试 ， 足 够 满足 对 项 目的 测试 需求 。 


1.28 可 执行 Jar 部 署 


由 于 Spring Boot MH AEk Web 容器 ， 因 此 提供 了 一 种 特殊 部 署 方式 ， 可 以 直接 利用 Maven 
或 者 Gradle 对 Spring Boot 项 目 进 行 打包 , 生成 一 个 JAR 文件 , 然后 直接 在 具备 环境 的 服务 器 或 本 
地 环境 中 利用 java -jar xx.jar 执行 JAR 文件 ， 使 应 用 能 够 快速 运行 。 


12.9 IDE 多 样 性 


正如 1.2.1 小 节 介 绍 的 ，Spring Boot 支持 的 开发 工具 很 多 ， 无 论 是 曾经 几乎 所 有 开发 者 都 使 用 
的 Eclipse 一 族 , 还 是 现在 流行 的 IntelliJ IDEA, 又 或 者 是 专门 为 开发 Spring 系列 而 生 的 Spring Tool 
Suite 都 是 开发 Spring Boot 应 用 的 不 二 法 宝 。 
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1.3 为 什么 要 学 习 Spring Boot 


为 什么 要 学 习 Spring Boot M? 这 可 能 是 很 多 读者 心中 的 疑惑 。 TE 1.2 节 , 我 们 通过 了 解 Spring 
Boot 的 特点 应 该 已 经 对 Spring Boot 框架 产生 了 一 定 的 兴趣 ， 接 下 来 笔者 将 从 几 个 方面 来 整体 曾 述 
学 习 Spring Boot 框架 的 理由 。 


131 简化 工作 


Spring Boot 最 大 的 优点 是 在 一 定 程度 上 简化 了 我 们 的 工作 ， 大 致 分 为 以 下 几 个 角度 对 工作 进 
行 简化 。 


”依赖 简化 : Spring Boot 自 有 的 starter 中 提供 了 一 些 可 以 快捷 使 用 的 依赖 ， 让 整合 或 集成 一 些 
常用 的 功能 更 便捷 。 

e 配置 简化 : 在 配置 方法 中 ， 如 果 没 有 特殊 情况 ，Spring Boot 为 我 们 提供 了 一 些 默认 的 配置 ， 
比如 端口 号 默认 为 8080 等 。 

e ”部署 简化 : 正如 前 面 介绍 的 可 执行 JAR ok 与 传统 服务 的 Web 模式 部 署 ( 打 WAR 包 部 署 ) 
相 比 ， 连 安装 Web 容器 的 时 间 都 节省 了 ， 不 只 是 开发 者 ， 对 运 维 人 员 也 是 福音 。 

e 监控 简化 : 可 以 通过 引用 Spring Boot HART UE EIE 无 代码 侵入 ,十 分 便捷 。 


1.8.2. ”微服 务 时 代 


“微服 务 ” 一 词 最 早 是 由 Martin. Fowler 的 《Microservices 》 一 文 (原文 链接 为 
https://martinfowler.com/articles/microservices.html) 提出 的 ， 其 核心 思想 是 将 一 个 单 体 应 用 根据 业 
务 功能 拆 分 成 为 多 个 服务 ， 使 业务 代码 之 间 不 再 耦合 。 接 下 来 ,我 们 介绍 一 下 由 单 体 应 用 转变 为 微 
服务 应 用 的 好 处 。 


1. 微服 务 的 优势 


e RARA: 将 单 体 应 用 转变 为 多 个 服务 ， 服 务 与 服务 之 间 通 过 HTTP 协议 或 其 他 约定 好 的 协 
议 等 进行 网 络 通信 人。 

o “技术 选 型 广泛 : 微服 务 不 需要 局 限于 固定 的 技术 栈 ， 各 个 服务 的 开发 团队 可 以 根据 场景 自由 
选择 开发 技术 ， 如 Java、PHP、NodeJs 等 。 

© ”服务 并 行 开发 : 可 以 多 个 团队 分 别 开 发 不 同 的 模块 ， 每 个 团队 负责 一 个 或 者 几 个 服务 ， 相 互 
不 受 影 响 。 

e 单一 职责 : 不 同 服务 的 团队 只 需要 关注 自己 团队 的 业务 , 无 须 经 常 为 了 熟悉 业务 而 耽误 时 间 。 

e 独立 部 署 : 由 于 每 个 服务 都 是 独立 的 项 目 ， 因 此 当 服 务 开发 完成 后 ， 可 以 直接 独立 部 署 。 

e 敏捷 开发 : 每 个 服务 的 业务 迭代 只 需要 更 新 对 应 服务 的 功能 即 可 ， 支 持 快速 适 代 .。 
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故障 隔离 : 在 传统 单 体 项 目 中 ， 如 果菜 个 功能 发 生 故障 ， 就 可 能 导致 整个 服务 发 生 宕 机 ， 但 
是 在 微服 务 中 ， 一 个 服务 发 生 宕 机 ， 其 他 服务 仍然 可 以 继续 工作 。 

. 微服 务 的 劣势 
部 署 需要 花费 更 多 的 精力 : 当 服 务 拆 分 得 非常 多 的 时 候 ， 可 能 需要 消耗 更 多 的 精力 去 运 维 管 
理 这 些 应 用 。 传 统 的 单 体 应 用 下 ， 运 维 人 员 只 需要 保证 一 个 服务 正常 运行 即 可 ， 但 是 拆 分 微 
服务 后 ， 可 能 需要 保持 几 十 ， 甚 至 上 百 、 上 千 的 服务 高 效 运行 ， 这 对 运 维 人 员 来 说 是 一 个 很 
大 的 挑战 。 
服务 间 的 接口 问题 : 正 因为 拆 分 了 微服 务 ， 服 务 与 服务 间 使 用 接口 进行 相互 调用 ， 当 一 个 接 
口 需要 改变 格式 或 者 增 减 数据 时 ， 所 有 调用 这 个 接口 的 服务 都 需要 做 出 相应 的 调整 才能 正确 
地 使 用 。 
高 可 用 : 拆 分 微服 务 后 ， 可 能 有 很 多 服务 需要 调用 同一 个 服务 或 者 接口 ， 这 个 服务 的 可 用 性 
就 需要 让 我 们 更 加 注意 。 
分 布 式 事务 : 微服 务 系统 各 个 服务 间 可 能 使 用 不 同 的 数据 库 , 比如 搜索 服务 使 用 Elasticsearch、 
基础 服务 使 用 MySQL、 评 论 服 务 使 用 MongoDB， 对 于 不 同 数据 库 间 数据 的 一 致 性 将 是 我 们 
面临 的 重大 挑战。 
网 络 复杂 性 : 由 于 各 个 服务 间 使 用 接口 调用 ， 因 此 系统 间 需 要 考虑 很 多 网 络 延迟 等 客观 因素 
来 保证 服务 间 的 正常 运转 。 
测试 的 复杂 性 : 在 测试 方面 ， 服 务 间 的 接口 调用 、 服 务 间 的 测试 需要 一 套 整 体 的 测试 方案 ， 
自动 化 测试 就 显得 必 不 可 少 。 


由 于 Spring Boot 项 目 可 以 提供 快速 开发 、 测 试 、 部 署 ， 因 此 Spring Boot 是 微服 务 应 用 的 不 二 


1.3.3 ”社区 背景 强大 


社区 背景 强大 其 实 是 Spring Boot 如 今 盛行 的 原因 。 众 所 周知 ，Spring 家 族 对 于 开发 者 提供 了 
无 尽 的 便利 ， 而 作为 Spring 的 亲 儿 子 “Spring Boot” 则 继承 了 一 切 Spring 的 优点 ， 并 且 规 避 了 很 
多 Spring 框架 腾 肿 的 缺点 ， 而 后 续 Spring 家 族 的 分 布 式 框架 Spring Cloud 也 是 基于 Spring Boot HE 
架 实 现 的 框架 ， 所 以 作为 Spring 的 爱好 者 , 或 者 将 要 学 习 Spring Cloud 框架 的 开发 者 ，Spring Boot 
是 必须 要 学 习 的 。 


1.3.4 ”市场 需求 


在 写 这 本 书 之 前 , 笔者 游历 于 各 大 国内 、 国 外 技术 论坛 , 无 论 是 在 国内 还 是 在 国外 , Spring Boot 
的 呼声 都 特别 高 ， 而 且 框 架 的 更 新 频率 特别 快 。 如 图 1-3 所 示 是 从 2014 年 到 2018 年 Spring Boot 
的 百度 搜索 指数 。 
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图 1-3 Spring Boot 百度 搜索 指数 (图 片 来 源 于 百度 搜索 指数 ) 


从 搜索 指数 可 以 看 出 ，Spring Boot 的 搜索 值 日 趋 增长 ， 关 注 度 特别 高 。 

另外 ， 我 们 从 互联 网 招聘 网 站 上 来 看 ， 已 经 有 超过 7 成 以 上 的 公司 将 Spring Boot 框架 作为 筛 
选 人 员 的 必要 条 件 ， 所 以 无 论 是 从 个 人 提升 ， 还 是 比较 实际 的 跳槽 、 涨 薪 等 ， 学 习 Spring Boot 都 
会 为 你 的 技术 栈 增光 添彩 。 


1.4 Spring Boot 的 发 展 历史 


Pivotal 团队 对 于 Spring Boot 更 新 得 非常 频繁 , 而 且 在 Github 和 国内 社区 的 关注 度 都 极 高 。 接 
下 来 我 们 看 一 下 Spring Boot 的 发 展 史 。 


1.4.1 ”发 布 里 程 碑 (2013.8.6) 


Phil Webb 在 Spring 官网 博客 上 宣布 了 一 个 名 为 Spring Boot 的 新 项 目的 第 一 个 里 程 碑 版 本 。 


1.4.2 Spring Boot 1.0 (2014.4) 


Spring Boot 问世 ， 为 所 有 Spring 开发 提供 快速 和 可 广泛 访问 的 入 门 体验 ， 其 中 版 本 功能 包括 
但 不 限于 以 下 几 点 : 
e GC AURA SS. 
e 外 部 配置 。 
e (UEM. 
. 
. 


快速 运行 。 
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1.4.3 Spring Boot 1.1 (2014.6) 


第 一 次 更 新 ， 下面 列 出 比较 重要 的 几 点 更 新 , 详细 版 本 内 容 可 以 查看 Spring Boot 的 Github 官方 
版 本 介绍 ， 地 址 为 https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-1.1-Release-Notes。 


对 spring-boot-starter-test 进行 修改 。 

新 增 对 Elasticseach 和 apache solr 的 自动 配置 支持 。 
新 增 框架 模板 Freemarker, Groovy 和 Velocity. 
Spring-WS 适用 于 Spring Web 服务 支持 。 

对 Jackson JSON 库 进行 了 改进 。 

添加 了 新 的 注解 。 


1.4.4 Spring Boot 1.2 (2015.3) 


对 之 前 的 版 本 进行 了 修订 ， 包 括 但 不 限于 以 下 更 新 ， 详 细 版 本 内 容 可 以 查看 Spring Boot 的 
Github 官方 版 本 介绍 ， 地 址 为 https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-1.2- 
Release-Notes。 


使 用 Tomcat 8 和 Jetty 9 ARAA Servlet 容器 ， 提 供 Servlet 3.1 和 增强 的 WebSocket 支持 。 
Spring 4.1, 

支持 JTA 实务 。 

提供 JMS 支持 。 

提供 电子 邮件 支持 。 


1.4.5 Spring Boot 1.3 (2016.12) 


对 之 前 的 版 本 进行 了 修订 ， 包 括 但 不 限于 以 下 更 新 ， 详 细 版 本 内 容 可 以 查看 Spring Boot 的 
Github 官方 版 本 介绍 ， 地 址 为 https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-1.3- 
Release-Notes。 


Spring 更 新 至 4.2。 

Spring Security 更 新 至 4.0。 

新 增 spring-boot-devtools ( 热 部 署 )。 
新 增 OAuth 2 的 支持 。 

缓存 自动 配置 。 


1.4.6 Spring Boot 1.4 (2017.1) 


对 之 前 的 版 本 进行 了 修订 ， 包 括 但 不 限于 以 下 更 新 ， 详 细 版 本 内 容 可 以 查看 Spring Boot 的 
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Github 官方 版 本 介绍 ， 地 址 为 https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-1.4- 
Release-Notes。 


Spring 更 新 至 4.3。 

Hibernate 更 新 至 5.0. 

提供 新 的 测试 模块 。 

Neo4J 和 Narayana 事务 管理 器 ，Caffeine cache、Elasticsearch Jest 支持 。 


1.4.7 Spring Boot 1.5 (2017.2) 


对 之 前 版 本 进行 了 修订 ,包括 但 不 限于 以 下 更 新 ,详细 版 本 内 容 可 以 查看 Spring Boot 的 Github 
官方 版 本 介绍 ， 地 址 为 https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-1.5-Release- 


Notes。 


修改 了 一 些 starter 的 命名 。 
OAuth2 资源 过 滤器 。 

新 的 记录 器 端点 。 

提供 Apache Kafka、LDAP 支持 。 


1.4.8 Spring Boot 2.0 (2018.3) 


Spring Boot 2.x 版 本 对 Spring Boot 进行 了 重大 的 改进 , 官网 介绍 如 图 1-4 所 示 。 该 版 本 对 之 前 
的 版 本 进行 了 修订 ， 包括 但 不 限于 以 下 更 新 ， 详 细 版 本 内 容 可 以 查看 Spring Boot 的 Github 官方 版 


本 介绍 ， 


地 址 为 https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-2.0-Release-Notes。 


基于 Java8， 支 持 Java 9。 

支持 Quartz 调度 程序 。 

大 大 简化 了 安全 自动 配置 。 

支持 嵌入 式 Netty. 

Tomcat. Undertow 和 Jetty 均 已 支持 HTTP/2. 

全 新 的 执行 器 架构 ， 支 持 Spring MVC. WebFlux 和 Jersey. 

使 用 Spring WebFlux/WebFlux.fn 提供 响应 式 Web 编程 支持 。 

为 各 种 组 件 的 响应 式 编程 提供 了 自动 化 配置 ， 如 Reactive Spring Data. Reactive Spring 
Security 等 。 

用 于 响应 式 Spring Data Cassandra. MongoDB, Couchbase 和 Redis 的 自动 化 配置 和 启动 器 
POM. 

引入 对 Kotlinl.2.x 的 支持 ， 并 提供 了 一 个 runApplication 函数 ， 让 你 通过 惯用 的 Kotlin 来 运 
£f Spring Boot 应 用 程序 。 更 多 信息 请 参阅 参考 文档 中 对 Kotlin 的 支持 部 分 。 

启动 时 的 ASCII 图 像 Spring Boot Banner 现 已 支持 GIF. 
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Reactive Stack 

Spring WebFlux is a non-blocking web 
framework built from the ground up to take 
advantage of multi-core, next-generation 
processors and handle massive numbers 
of concurrent connections. 


Netty, Servlet 31* Containers 
Reactive Streams Adapters 
Spring Security Reactive 
Spring WebFlux 


Spring Data Reactive Repositories 
Mongo, Cassandra, Redis, Couchbase 


© Spring Boot 2.0 


Reactor 


Servlet Stack 
Spring MVC is built on the Servlet API 
and uses a synchronous blocking I/O 
architecture with a one-request-per- 
thread model. 


Servlet Containers 
Servlet API 
Spring Security 
Spring MVC 


Spring Data Repositories 
JDBC, JPA, NoSQL 


图 14 Spring Boot 2.0 的 改动 〈 图 片 来 源 于 Spring 官网 : http://spring.io/) 


1.5 小 结 


本 章 从 多 个 角度 带领 大 家 了 解 Spring Boot， 并 且 介 绍 了 Spring Boot 历史 版 本 的 更 迭 以 及 学 习 
它 会 给 我 们 带 来 的 好 处 ， 内 容 可 能 略 显 乏 味 。 第 2 章 将 带领 大 家 构建 开发 Spring Boot 的 环境 ， 让 
我 们 走 进 Spring Boot。 


走 进 Spring Boot 


第 1 章 介绍 了 Spring Boot 的 特点 及 发 展 历史 ， 阅 读 起 来 可 能 会 有 一 些 枯燥 ， 但 是 间接 地 映射 
出 了 尽快 学 习 掌握 Spring Boot 的 重要 性 。 本 章 将 带领 大 家 搭建 Spring Boot 的 开发 环境 ， 并 且 引 领 
大 家 简单 地 构建 项 目 ， 以 及 对 项 目的 简单 使 用 。 


2.1 环境 搭建 


正 所 谓 “ 工 欲 善 其 事 ， 必 先 利 其 器 ”， 正 如 我 们 学 习 Java 时 一 样 ， 先 要 搭建 环境 ， 才 能 真正 
进行 开发 和 部 署 。 所 以 ， 本 节 将 对 Spring Boot 的 开发 环境 进行 搭建 ， 第 一 个 需要 安装 的 是 JDK。 
当今 主流 的 Java 开发 工具 有 Eclipse. Intellij IDEA, Spring Tool Suite 以 及 MyEclipse 等 。 本 书 中 
的 实例 全 部 使 用 IntelliJ IDEA 作为 IDE 进行 开发 ， 使 用 Apache Maven 构建 项 目 。 


211 JDK 安装 


本 书 中 使 用 的 是 Spring Boot 2.0.3 版 本 ，Spring Boot 2.x 以 上 版 本 需要 JDK 1.8 以 上 ， 所 以 我 
们 需要 去 官网 下 载 JDK1.8 以 上 的 版 本 。 登 录 官 网 Chttp://www.oracle.com/technetwork/java/javase/ 
downloads/index.html) ， 下 载 一 个 适合 自己 系统 的 JDK1.8 安装 包 ， 然 后 进行 安装 。 安 装 完成 之 后 ， 
配置 一 下 环境 变量 ， 然 后 在 终端 或 者 Windows 控制 台 (CMD) 输入 查看 JDK 版 本 的 命令 ， 如 代码 
清单 2-1 所 示 。 


代码 清单 2-1 EA JDK 版 本 


java -version 
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如 果 出 现 如 图 2-1 所 示 的 界面 ， 就 证 明 JDK 安装 成 功 了 。 


dalaoyang-3:- daleoyang$ java -version 
java version "1.8.0131" 


Java(TM) SE Runtime Environment (build 1.8.0 131-b11) 
Java HotSpot(TM) 64-Bit Server VM (build 25.131-b11, mixed mode) 
dalaoyang-3:- daleoyang$ 


图 2-1 JDK 安装 成 功 查看 图 


2.1.2 IntelliJ IDEA 的 安装 


登录 IntelliJ IDEA 官网 (下载 地 址 : https://www.jetbrains.com/idea/download/) ， 如 图 2-2 所 示 ， 
下 载 合适 的 版 本 ， 笔 者 使 用 的 是 2018.1 版 本 ， 有 具体 可 以 根据 自己 的 情况 下 载 ， 各 版 本 之 间 的 差异 
不 是 很 大 ， 下 载 完成 之 后 安装 即 可 (需要 注意 的 是 ，Intellij IDEA 是 一 款 收 费 软件 ， 大 家 可 以 申请 
免费 使 用 一 年 ， 根 据 自 己 的 喜好 选择 IDE) 。 


[IIN BE D 


Windows macos 
Ultimate Community 
For web and enterprise For JVM and Android 
development development 


eh 


图 2-2 IntelliJ IDEA 官网 下 载 页 面 


2.1.3 Maven 的 安装 


Maven 是 一 个 比较 常用 的 项 目 管理 工具 ， 同 时 提供 了 出 色 的 应 用 程序 构建 能 力 。 通 常 可 以 通 
过 几 行 命令 构建 一 个 简单 的 应 用 程序 。 

由 于 本 书 是 使 用 Maven 构建 应 用 的 ,因此 我 们 需要 安装 一 个 Maven 管理 工具 .通过 登录 Apache 
Maven 官网 (Apache Maven 官网 地 址 : https://maven.apache.org/download.cgi) 下 载 一 个 3.2 以 上 的 
版 本 ， 如 图 2-3 所 示 。 
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Maverr 


Dowload Get Sources | Last Published: 2018-11-01 


System Reguirements 


Java 
Development 
[m 


Maven 3.3+ requie JDK 1.7 or above to exacte - they stil alows you to bul against 1.3 and other JOK versions by Using To: 


2-3 在 Apache Maven 官网 下 载 


可 以 根据 系统 下 载 压缩 包 ,， 下载 之 后 在 本 地 解压 , 解压 完成 后 需要 配置 一 下 Maven 环境 变 
配置 完成 后 在 终端 或 者 Windows 控制 台 (CMD) 输入 查看 Maven 版 本 的 命令 ， 如 代码 清单 
所 示 。 


量 
2- 


, 
2-2 


代码 清单 2-2 查看 Maven 版 本 


mvn -v 


如 果 出 现 如 图 2-4 所 示 的 界面 ， 就 证 明 Maven 环境 变量 配置 成 功 了 。 
eoe ache-maven 


dalaoyang-3:apache-maven-3.5.2 dalaoyang$ mvn -v 
Apache Maven 3.5.2 (138edd6lfdig8ec658bfa2d307c43b76940a5d7d; 2017-10-18T15:58:1 


0x24 


laLaoyang/apache-maven-3.5.2 
131, vendor: Oracle Corporation 

Java home: /Library/Javo/JavaVirtualMachines/jdk1.8.0 131. jdk/Contents/Home/jre 

Default locale: zh CN, platform encoding: UTF-8 

OS name: "mac os x", version: "10.14", ar x86. 64", family: 


"mac" 
dalaoyang-3:apache-maven-3.5.2 dalaoyano$ 


2-4 查看 Maven 环境 变量 


Maven 环境 变量 到 这 里 已 经 配置 完成 了 。 但 是 在 默认 情况 下 ，Maven 下 载 JAR 可 能 会 有 一 些 
慢 , 可 以 修改 为 国内 阿里 云 等 下 载 地 址 , 如 代码 清单 2-3 所 示 , 这 是 笔者 Maven 的 配置 (settings.xml 
配置 ) ， 可 以 根据 需求 自行 修改 。 


代码 清单 2-3 ”Maven settings.xml 配置 


<?xml version-"1.0"?» 


«settings? 


XlocalRepository»/Users/dalaoyang/maven repository«/localRepository»«!-- 


需要 改 成 自己 的 Maven 的 本 地 仓库 地 址 --> 
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«mirrors» 
«mirror» 
Xid»alimavenc/id» 
<name>aliyun mavenc/name» 
«url»http://maven.aliyun.com/nexus/content/groups/public/ «/url» 
«mirrorOf»central«/mirrorOf» 
«/mirror» 
«/mirrors» 
«profiles» 
«profile» 
«id»nexusc/id» 
«repositories» 
«repository» 
«id»nexus«/id» 
«name»local private nexusc/name» 
«url»http://maven.oschina.net/content/groups/public/«/url» 
«releases» 
Xenabled»true«/enabled» 
</releases> 
<snapshots> 
<enabled>false</enabled> 
</snapshots> 
</repository> 
</repositories> 


<pluginRepositories> 
<pluginRepository> 
<id>nezus</id> 
<name>local private nexus</name> 
«url»http://maven.aliyun.com/nexus/content/groups/public/«/url» 
«releases» 
X«enabled»5true«/enabled» 
«/releases» 
«snapshots» 
«enabled»false«/enabled» 
«/snapshots» 
«/pluginRepository» 
«/pluginRepositories» 
«/profile»«/profiles» 
«/settings» 
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2.1.4 IntelliJ IDEA 内 配置 JDK 和 Maven 


1. 配置 JDK 


打开 IntelliJIDEA， 在 菜单 栏 单 击 Project Structure， 然 后 在 左 侧 单 击 SDKs， 单 击 + 号 ， 选 择 自 
己 刚刚 安装 的 JOK 即 可 ， 如 图 2-5 所 示 


图 2-5 IntelliJ IDEA 配置 JDK 
2. 配置 Maven 


在 菜单 栏 单 击 Preferences, 在 搜索 栏 搜索 maven， 单 击 查询 到 的 Maven, 在 右 侧 配置 刚刚 安装 
的 Maven， 如 图 2-6 所 示 。 


2-6 Intellij IDEA 配置 Maven 
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其 中 ， 需 要 配置 以 下 三 项 。 

* Maven home directory: 选择 刚刚 安装 的 Maven. 

* User settings file: 配置 安装 的 Maven 中 conf 目录 下 的 settings.xml。 
* Local repositroy: 配置 Maven 下 载 JAR 包 的 位 置 。 


到 这 里 ， 所 有 配置 和 搭建 都 已 经 完成 了 。 


2.2 新建 Spring Boot Ii El 


本 节 将 介绍 IntelliJ IDEA 使 用 Spring Initializr 创 TT 
建 Spring Boot 项 目 。 


IJ 


224 开始 创建 项 目 IntelliJ IDEA 


第 一 次 打开 IntelliJ IDEA 或 者 之 前 关闭 了 Intellij 
IDEA, 可 以 看 到 如 图 2-7 所 示 的 界面 , 其 中 可 以 创建 
项 目 、 导 入 项 目 、 打 开 项 目 或 者 从 版 本 管理 工具 内 导 
入 项 目 。 

如 果 你 之 前 打开 过 项 目 ， 重 新 打开 Intellij IDEA 
会 默认 打开 上 次 打开 的 项 目 。 当 然 ， 我 们 也 可 以 在 
IDEA 的 菜单 栏 选 择 New 进行 创建 应 用 的 操作 , 如 图 
2-8 所 示 。 


mm 
Sync Settings to JetBrains Account... 


Q Synchronize 
invalidate Caches / Restart... 


Export to HTML... 
© Print... 


Add to Favorites 


Line Separators 
Make Directory Read-ony 


2-8 IntelliJ IDEA 创建 项 目 界面 
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2.2.2 M JDK 版 本 和 Initializr Service URL 


打开 New Project 界面 后 ， 在 左 侧 选择 Spring Initializr， 如 图 2-9 所 示 。 选 择 后 右边 会 有 两 个 
选项 ， 第 一 项 是 选择 JDK 版 本 ， 由 于 本 书 均 采 用 Spring Boot 2.0.3 版 本 ， 最 低 支持 JDK1.8， 因 此 
我 们 选择 JDK1.8。 下 面 的 Initializr Service URL 是 用 来 查询 Spring Boot 的 当前 版 本 和 组 件 的 网 站 。 
这 两 个 选项 配置 完成 之 后 ， 单 击 下 方 的 Next 按钮 进入 下 一 个 步骤 。 


图 2-9 InteliJIDEA- 配 置 JDK 版 本 和 Initializr Service URL 


2.2.3 配置 Project Metadata 信息 


Project Metadata 配置 信息 包含 如 下 内 容 ， 如 图 2-10 所 示 。 

Group: 项 目 组 织 的 标识 符 。 

Artifact: 项 目标 识 符 。 

Type: 构建 项 目的 方式 ， 包 含 Maven 和 Gradle， 这 里 选择 Maven Project, 
Language: 编程 语言 ， 这 里 选择 Java。 

Packaging: 启动 形式 ， 包 含 JAR 和 WAR， 这 里 我 们 选择 JAR。 

Java Version: Java 版 本 。 

Version: 项 目 版 本 号 。 

Name: 项 目 名 称 。 

Description: 项 目 描述 。 

Package: 实际 对 应 Java 包 的 结构 ， 是 main 目录 里 Java 的 目录 结构 。 
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图 2-10 IntelliJ IDEA-ĦE F Project Metadata 信息 


2.24 配置 Spring Boot 版 本 及 默认 引入 组 件 


在 Spring Boot 下 拉 框 中 选择 当前 推荐 的 Spring Boot 版 本 , 在 下 方 选择 要 使 用 的 组 件 ,然后 单 
击 Next 按钮 ， 如 图 2-11 所 示 。 


图 2-11 IntelliJIDEA- 配 置 Spring Boot 版 本 及 默认 引入 组 件 


2.25 配置 项 目 名 称 和 项 目 位 置 


在 Project Name 处 配置 项 目 名 称 ， 在 Project Location 处 配置 项 目 位 置 ， 如 图 2-12 所 示 。 配 置 
完成 后 ， 单 击 Finish 按钮 即 可 完成 项 目的 创建 。 
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2-12. ”ItelliJIDEA- 配 置 项 目 名 称 和 项 目 位 置 
到 这 里 ， 我 们 已 经 完成 了 项 目的 创建 。2.3 节 将 对 项 目的 目录 结构 等 进行 进一步 的 介绍 。 


23 项 目 工程 介绍 


本 节 继 续 使 用 2.2 节 创建 的 项 目 。 如 图 2-13 所 示 。 本 节 将 介绍 项 目的 工程 目录 结构 ,从 图 2-13 
中 可 以 看 到 大 致 分 为 4 部 分 。 

CD Java 类 文件 

(20 资源 文件 

(3) 测试 类 文件 

(4) pom 文件 


2-13 ItelliJIDEA- 项 目 工程 介绍 
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2.3.1 Java 类 文件 


src/main/ava 下 用 于 放置 Java 类 文件 ， 由 于 这 是 一 个 新 建 的 项 目 ， 因 此 目前 只 有 一 个 
DemoApplication 类 ， 如 图 2-14 所 示 。 这 个 类 是 Spring Boot 应 用 的 主 程序 ， 其 中 
@SpringBootApplication 注解 用 来 说 明 这 是 Spring Boot 应 用 的 启动 类 , 其 中 包含 自动 配置 、 包 扫描 
等 功能 ，main 方法 是 启动 应 用 的 入 口 方法 ， 命 令 行 或 者 插件 等 任何 方式 启动 ， 都 会 调用 这 个 方法 。 


2-14 IntelliJ IDEA-DemoApplication 类 


2.32 资源 文件 


1. 配置 文件 


src/main/resources 下 面 主要 用 于 放置 Spring Boot 应 用 的 配置 文件 ， 新 建 项 目的 时 候 会 默认 创 
建 一 个 application.properties (默认 是 一 个 空 文件 ) ， 也 可 以 将 .properties 文件 修改 为 .yml 文件 ， 用 
缩 进 结构 的 键 值 对 来 进行 配置 。 同 时 , 配置 文件 可 以 进行 一 些 应 用 需要 的 配置 ， 如 端口 号 等 ， 后续 
章节 会 陆续 介绍 。 


2. 静态 资源 
src/main/resources/static 下 面 主要 放置 应 用 的 静态 资源 文件 ， 如 HTML、JavaScript、 图 片 等 。 
3. 模板 文件 


src/main/resources/templates 下 面 主要 放置 应 用 的 模板 文件 , 比如 使 用 Thymeleaf 后 的 Thymeleaf 
模板 文件 等 。 


2.3.3 测试 类 文件 


src/tesjava 下 用 于 放置 Spring Boot 测试 类 文件 ， 默 认 会 根据 项 目 名 称 创建 一 个 测试 类 ， 如 
图 2-15 所 示 。 打 开 该 类 可 以 发 现 @SpringBootTest 注解 用 于 标明 这 是 一 个 Spring Boot 测试 类 。 


2-15 IntelliJ IDEA-DemoApplicationTests 类 
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2.3.4 pom 文件 


项 目 中 还 包含 一 个 pom.xml 文件 ， 这 是 Maven 项 目 用 于 构建 项 目的 重要 组 成 部 分 。 从 pom XC 
件 的 完整 代码 中 可 以 看 到 新 建 的 Spring Boot 项 目 默认 的 依赖 以 及 版 本 号 、Java 版 本 等 ， 如 代码 清 
单 2-4 所 示 。 


代码 清单 2-4 Spring Boot 应 用 程序 pom 文件 代码 清 


<?xml Version="1.0" encoding-"UTF-8"?» 
<project xmlns-"http://maven.apache.org/POM/4.0.0" xmlns:xsi- 
"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/xsd/maven-4.0.0.xsd"» 
«modelVersion»4.0.0«/modelVersion» 


XgroupId»com.examplec/groupId» 
X«artifactId»demo«/artifactId» 
«version»0.0.1-SNAPSHOT«/version» 
Xpackaging»jar«/packaging» 


<name>demo</name> 
<description>Demo project for Spring Boot</description> 


<parent> 
XgroupId»org.springframework.boot«/groupId» 
Xartifactld»spring-boot-starter-parent«/artifactlId» 
«version»2.0.3.RELEASE«/version» 
XrelativePath/» «!-- lookup parent from repository --» 
«/parent» 


«properties» 
Xproject.build.sourceEncoding»UTF-8«/project.build.sourceEncoding» 
Xproject.reporting.outputEncoding^UTF-8 

«/project.reporting.outputEncoding» 
«java.version»1.8«/java.version» 
«/properties» 


Xdependencies» 

«dependency» 
X«groupId»org.springframework.boot«/groupId» 
XartifactlId»spring-boot-starter«/artifactlId» 

«/dependency» 


<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-test</artifactId> 
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<scope>test</scope> 
</dependency> 
</dependencies> 


<build> 
<plugins> 
<plugin> 
XgroupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-maven-plugin«/artifactId» 
«/plugin» 
«/plugins» 
«/build» 


«/project» 


24 运行 项 目 


在 此 之 前 ， 我 们 已 经 简单 地 搭建 了 一 个 Spring Boot 项 目 。 接 下 来 介绍 在 IntelliJ IDEA 上 如 何 
运行 项 目 。 其 实 很 简单 ， 可 以 直接 使 用 Intelli) IDEA 的 Run 或 者 Debug 来 启动 ， 或 者 利用 我 们 在 
2.3 节 介绍 的 Spring Boot 主 程序 ， 直 接 运 行 主 程序 中 的 main 函数 来 运行 项 目 。 无 论 采 用 哪 一 种 ， 
都 可 以 启动 项 目 。 然 后 查看 控制 台 ， 如 图 2-16 所 示 。 


2-16 Spring Boot 启动 Log 


2.5 小 结 


本 章 对 Spring Boot 开发 环境 进行 了 搭建 ， 介 绍 了 使 用 IntelliJ IDEA 创建 项 目的 方法 和 步骤 ， 
以 及 创建 后 的 项 目 工程 , 最 后 介绍 了 如 何在 Intellij IDEA 中 运行 项 目 。 到 这 里 可 能 还 是 有 一 些 枯燥 ， 
但 是 当 看 到 启动 项 目的 banner 时 可 能 会 焕然 一 新 。 截 至 目前 ， 准 备 工作 已 经 做 好 了 ， 接 下 来 将 会 
进行 真正 的 Spring Boot 之 旅 。 


Spring Boot 的 Web 之 旅 
在 开发 中 , Web 项 目 与 我 们 息息相关 , 本 章 将 介绍 Spring Boot 的 Web 项 目 , 从 构建 简单 项 目 、 
使 用 模板 框架 、WebJars 等 进行 系统 性 的 学 习 。 
3.1 Spring Boot 的 第 一 个 Web 项 目 


打开 IntelliJ IDEA， 新 建 一 个 简单 的 项 目 ， 过 程 与 第 2 章 介 绍 的 一 致 。 
3.1.1 加 入 Web 依赖 


创建 项 目 后 , 在 项 目的 pom 文件 中 加 入 Web 依赖 , 并 且 导入 依赖 文件 ,如 代码 清单 3-1 所 示 。 


代码 清单 3-1 Spring Boot-Web 依赖 


«dependency» 
XgroupId»org.springframework.boot«/groupId» 
XartifactlId^spring-boot-starter-web«/artifactId» 

«/dependency» 


3.1.2 创建 Controller 


新 建 一 个 HelloController， 在 类 上 加 入 注解 @RestController， 了 解 Spring MVC 的 都 知道 ， 这 
个 注解 是 Spring 4.0 版 本 之 后 的 一 个 注解 ， 功 能 相当 于 @Controller 与 @ResponseBody 两 个 注解 的 
功能 之 和 。 
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在 HelloController 内 创建 方法 hello()， 在 方法 上 加 入 注解 @GetMapping("/hello")， 这 个 注解 是 
在 Spring 后 期 推出 的 一 个 组 合 注解 ， 是 @RequestMapping(method = RequestMethod.GET) 的 缩写 ， 
将 HTTP Get 映射 到 方法 上 。 让 hello0 返 回 一 个 字符 串 “Hello, This is your first Spring Boot Web 
Project!" . HelloController 的 完整 内 容 如 代码 清单 3-2 所 示 。 


代码 清单 3-2 HelloController 的 完整 内 容 


Package com.springboot.controller; 


import org.springframework.web.bind.annotation.GetMapping; 


import org.springframework.web.bind.annotation.RestController; 


GRestController 
public class HelloController ( 


GGetMapping("/hello") 
public String hello()( 


return "Hello , This is your first SpringBoot Web Project !"; 


3.1.3 ”测试 运行 


截至 目前 ， 其 实 简单 的 Web 项 目 已 经 创建 完成 了 ， 接 下 来 启动 项 目 。 首 先 观察 一 下 控制 台 ， 
如 图 3-1 所 示 ， 我 们 似乎 得 到 几 个 信息 : 项 目的 端口 是 8080、 默 认 使 用 的 Web 容器 是 Tomcat. Hill 
刚 写 的 hello0) 在 控制 台 有 所 映射 。 


(s): 8 ext path 
ation in M! ruming for 4. 


3-1 Spring Boot-Web 项 目 启动 Log 


在 浏览 器 上 访问 http://localhost:8080/hello， 可 以 看 到 浏览 器 打印 了 我 们 在 方法 内 返回 的 内 容 。 


Hello , This is you first SpringBoot Web Project ! 
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到 这 里 ， 一 定 会 有 人 和 笔者 第 一 次 接触 的 时 候 有 同样 的 想法 。Spring Boot 项 目 太 神 奇 了 ， 完 
全 颠覆 了 我 们 对 传统 Web 项 目的 认识 ， 它 没有 原 有 的 web.xml 文件 ， 只 需 短 短 的 几 行 代码 ， 就 完 
成 了 原 有 Spring MVC 项 目的 烦琐 配置 , 甚至 连 配 置 Tomcat 都 不 需要 , 直接 在 内 部 提供 了 Tomcat. 


3.2 WebFlux 的 使 用 


前 面 介绍 了 Spring Boot 使 用 Spring MVC 模式 搭建 一 个 简单 的 WebFlux 项 目 ， 本 节 为 大 家 介 
绍 Spring Boot 提供 的 另 一 种 模式 一 一 Spring WebFlux。 引 用 Spring 官网 的 说 明 ， 我 们 在 第 1 章 已 
经 看 到 过 ， 如 图 3-2 所 示 。 


© Spring Boot 2.0 


+) Reactor 


Reactive Stack Servlet Stack 
Spring WebFlux is a non-blocking web Spring MVC is built on the Servlet API 
framework built from the ground up to take and uses a synchronous blocking VO 
advantage of multi-core, next-generation architecture with a one-request-per- 
processors and handle massive numbers thread model. 

of concurrent connections. 


Netty. Serviet 3.1: Containers 
Reactive Streams Adapters. 
Spring Security Reactive. 
Spring WebFlux 


Spring Data Reactive 
Mongo. Cassandra, Redis, Couchbase 


图 3-2 Spring MVC 与 Spring WebFlux 比较 图 


从 图 3-2 可 以 看 到 ，WebFlux 是 一 个 非 阻塞 的 Web 框架 ， 它 不 再 完全 依赖 于 Servlet， 而 是 实 
现 了 Reactive Streams 规范 。 也 就 是 说 ， 可 以 使 用 响应 式 编程 ， 但 是 并 非 无 法 运行 在 之 前 的 Servlet 
容器 上 ， 只 不 过 必须 是 在 Servlet 3.1 以 上 ， 并 且 默 认 推 荐 的 是 使 用 Netty 这 种 异步 容器 。 刚 才 我 们 
提 到 了 响应 式 编程 ， 接 下 来 利用 响应 式 编程 来 创建 一 个 Spring Boot WebFlux 项 目 。 


3.2.1 添加 WebFlux 依赖 


首先 创建 一 个 项 目 ， 在 项 目的 pom 文件 中 添加 WebFlux 依赖 。Spring WebFlux 同样 支持 传统 
Spring MVC 使 用 注解 的 形式 进行 WebFlux 跳 转 , 同时 支持 函数 式 编程 配置 路 由 进行 WebFlux 跳 转 。 
传统 模式 就 不 再 袭 述 了 ， 这 里 以 响应 式 编程 为 例 ，Spring WebFlux 依赖 的 内 容 如 代码 清单 3-3 所 示 。 


代码 清单 3-3 Spring Boot-WebFlux 依赖 


<dependency> 
<groupId>org.springframework.boot</groupId> 
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<artifactId>spring-boot-starter-webflux</artifactId> 
</dependency> 


3.2.2 ”创建 一 个 处 理 方法 类 


新 建 类 HelloHandle， 创 建 一 个 hello 方法 供 接 下 来 使 用 ， 其 中 返回 值 Mono<ServerResponse> 
作为 响应 对 象 ， 其 中 ServerResponse 包含 响应 状态 、 响 应 头 信息 等 ， 类 上 面 的 @Component 注解 用 
于 将 类 实例 化 到 Spring 容器 中 。 总 的 来 说 ， 这 个 方法 就 是 返回 一 句 字 符 串 ，HelloHandle 类 的 内 容 
如 代码 清单 3-4 所 示 。 


代码 清单 3-4 Spring Boot-WebFlux mA HelloHandle 的 内 容 


GComponent 
public class HelloHandle ( 


public Mono«ServerResponse» hello(ServerRequest request)( 
return ServerResponse.ok().contentType (MediaType.APPLICATION JSON) 
-body(BodyInserters.fromObject("Hello, This is a Spring Boot 
WebFlux Project !")); 
} 


3.2.3 ”创建 一 个 Router 类 


创建 一 个 HelloRouter 类 ， 用 来 定义 路 由 信息 ， 每 个 路 由 都 会 映射 到 对 应 的 处 理 方法 〈 功 能 类 

似 于 @RequestMapping) 。 当 接收 到 对 应 HTTP. 请 求 后 ， 调 用 此 方法 ， 通 过 RouterFunctions.route 

(RequestPredicate, HandlerFunction) 提供 一 个 路 由 器 函数 的 默认 实现 ，HelloRouter 的 内 容 如 代码 
清单 3-5 所 示 。 


代码 清单 3-5 Spring Boot-WebFlux mA HelloRouter 的 内 容 


GConfiguration 
public class HelloRouter ( 


@Bean 
public RouterFunction<ServerResponse> routeHello (HelloHandle 
helloHandle) { 
return RouterFunctions 
.route (RequestPredicates.GET("/hello") 
.and (RequestPredicates.accept (MediaType.APPLICATION JSON)), 
helloHandle::hello); 
h 
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3.2.4 测试 运行 


启动 项 目 ， 我 们 来 观察 一 下 控制 台 ， 如 图 3-3 所 示 。 可 以 从 第 4 行 看 到 ， 刚 刚 写 的 hello 映射 
已 经 成 功 了 。 正 如 之 前 介绍 的 ， 默 认 启用 的 Netty 容器 运行 端口 默认 为 8080。 


图 3-3 Spring Boot- WebFlux 项 目 启动 Log 
在 浏览 器 上 访问 http://localhost:8080/hello 可 以 看 到 : 
Hello, This is a Spring Boot WebFlux Project ! 
响应 式 编程 的 简单 实现 到 这 里 就 结束 了 ， 可 能 在 工作 和 学 习 上 两 种 方式 有 不 同 的 使 用 情况 ， 
无 论 是 响应 式 编程 还 是 非 响 应 式 编程 ,都 有 各 自 不 同 的 好 处 ,这 里 不 做 更 多 的 比较 了 ， 具体 可 以 按 
照 自己 的 实际 需求 来 选择 。 


3.8 ”使 用 热 部 署 


热 部 署 这 个 词汇 大 家 听 起 来 应 该 并 不 陌生 ， 在 Spring Boot 框架 中 是 否 提供 了 相关 的 热 部 署 
呢 ? 其 实在 第 1 章 介 绍 Spring Boot 框架 的 特点 时 已 经 指出 了 ， 只 需要 引入 spring-boot-devtools 依 
赖 文 件 即 可 ， 十 分 简单 。 引 入 依赖 后 ， 重 新 编译 修改 的 类 文件 或 配置 文件 等 〈 笔 者 默认 快捷 键 是 
Command+F9) , Spring Boot 框架 会 自动 替 我 们 重启 ，spring-boot-devtools 依赖 如 代码 清单 3-6 所 


代码 清单 3-6 spring-boot-devtools 依赖 内 容 


<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-devtools</artifactId> 
<scope>runtime</scope> 

</dependency> 
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3.4 配置 文件 


在 第 2 章 介 绍 Spring Boot 项 目 结构 的 时 候 简单 提 到 了 配置 文件 , 本 节 将 对 Spring Boot 的 配置 
文件 进行 介绍 。 


3.4.1 配置 文件 类 型 


在 使 用 IntelliJ IDEA 创建 Spring Boot 项 目 时 ，IDE 会 在 src/main/java/resources 目录 下 创建 一 
个 application.properties 文件 。 在 这 种 情况 下 ， 我 们 使 用 配置 的 时 候 需 要 使 用 下 面 的 格式 〈 以 端口 
号 配置 为 例 ) ， 如 代码 清单 3-7 所 示 。 


代码 清单 3-7 properties 文件 配置 端口 号 


server.port-8888 


当然 ， 我 们 也 可 以 将 配置 文件 application.properties 后 组 修改 为 .yml 格式 ， 即 文件 全 名 为 
application.yml。 在 这 种 格式 下 ， 端 口 配置 如 代码 清单 3-8 所 示 。 


代码 清单 3-8 YML 文件 配置 端口 号 


server: 
port:8888 


342 自 定 义 属性 


前 面 介 绍 了 两 种 配置 文件 的 格式 ， 这 里 以 properties 文件 为 例 ,在 application.properties 中 自 定 
义 几 个 属性 ， 如 代码 清单 3-9 所 示 。 


代码 清单 3-9 Spring Boot 配置 自 定 属性 


book.name=Spring Boot 2 实战 之 旅 
book .author= 杨 洋 


在 类 中 ， 如 果 需 要 读 取 配 置 文件 的 内 容 ， 那 么 只 需要 在 属性 上 使 用 @Value("${ 属 性 名 }")， 新 
建 一 个 TestController， 在 其 中 创建 一 个 testl 方法 进行 测试 。TestController 的 完整 内 容 如 代码 清单 
3-10 所 示 。 


代码 清单 3-10 ”TestController 类 的 完整 内 容 


@RestController 
public class TestController { 
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GValue("$(book.name]") 
private String bookName; 


GValue ("$(book.author)") 
private String bookAuthor; 


GGetMapping("testi") 
public String testl()( 
return "本 书 书 名 是 : " + bookName + ", 作 者 是 : " + bookAuthor; 
) 


启动 工程 ， 在 浏览 器 上 访问 http://localhost:8080/test1， 可 以 看 到 浏览 器 显示 : “本 书 书 名 是 : 
Spring Boot 2 实战 之 旅 ,作者 是 : 杨洋 ”。 


在 application.properties 中 配置 中 文 值 ， 读 取 时 会 出 现 中 文 乱 码 问 题 。 因 为 Java 默认 会 使 用 


ISO-8859-1 的 编码 方式 来 读 取 *.properties 配置 文件 ， 而 SpringBoot 应 用 则 以 UTF-8 的 编码 
方式 来 读 取 ， 就 导致 产生 了 乱码 问题 。 


对 于 这 个 问题 ， 官 方 推荐 的 做 法 是 : “Characters that cannot be directly represented in this 
encoding can be written using Unicode escapes”， 大 致意 思 就 是 使 用 Unicode 的 方式 来 展示 字符 。 例 
如 上 述 代 码 中 的 book.author= 杨 洋 应 该 配置 成 book.author=\u6768\u6d0b。 


3.4.3 ”使 用 随机 数 


在 配置 文件 中 ， 还 提供 了 随机 数 供 我 们 使 用 ， 即 在 配置 文件 中 使 用 ${random} 来 生成 不 同类 型 
的 随机 数 ， 大 致 分 为 随机 数 、 随 机 uuid、 随 机 字符 串 等 。 在 配置 文件 内 添加 几 种 利用 随机 数 创建 
的 属性 ， 如 代码 清单 3-11 所 示 。 


代码 清单 3-11 配置 文件 使 用 随机 数 
+ 随机 字符 串 


book.value-$(random.value] 

+ 随机 int 值 
book.intValue-$(random.int] 

# 随机 long 值 
book.longValue-$(random.long] 
# 随机 uuid 


book.uuid-$(random.uuid] 
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# 1000 以 内 随机 数 

book.randomNumber=$ {random.int(1000)} 
# 自 定义 属性 间 引 用 

book.title= 书 名 是 : $(book.name] 


在 配置 了 这 么 多 属性 后 ， 可 以 使 用 JavaBean 模式 来 给 属性 赋值 ， 创 建 一 个 BookConfigBean 
实体 类 。 由 于 自 定义 属性 的 前 缀 都 是 由 book 开头 的 ， 因 此 我 们 可 以 在 实体 类 上 加 入 注解 
@ConfigurationProperties(prefix =  "book") ， 同 时 需要 在 启动 类 上 加 入 注解 
@EnableConfigurationProperties(BookConfigBean.class)， 表 明 启 动 这 个 配置 类 。 实 体 类 内 容 如 代码 
清单 3-12 所 示 ( 这 里 省 略 了 set. get 方法 ) 。 


代码 清单 3-12 ”BookConfigBean 类 的 完整 内 容 


GConfigurationProperties (prefix = "book") 
public class BookConfigBean ( 

private String name; 

private String author; 

private String value; 

private int intValue; 

private long longValue; 

private String uuid; 

private int randomNumber; 

private String title; 


H 
到 这 里 , 配置 就 完成 了 。 接 下 来 在 TestController 中 利用 @Autowired 注解 注入 BookConfigBean 


K, 并 且 创 建 一 个 test2 方法 进行 测试 。test2 方法 及 注入 BookConfigBean 类 的 内 容 如 代码 清单 3-13 
所 示 。 


代码 清单 3-13  TestController 类 新 增 内 容 


@Autowired 
Private BookConfigBean bookConfigBean; 


@GetMapping ("test2") 

Public BookConfigBean test2(){ 
return bookConfigBean; 

b 


在 浏览 器 上 访问 http://localhost:8080/test2 进行 测试 ， 显 示 结 果 如 下 : 


("name":"Spring Boot 2 实战 之 旅 ", "author":" 杨 洋 ", "value": 
"014ccb5£689£3c2b528a32cd755d43921","intValue":—-719017145,"longvalue":78148173 
79928523304, "uuid":"a800992e-8262-426d-8aab-66aae9df798a", "randomNumber":918, 
"title":" 本 书 书 名 是 : ”spring Boot 2 实战 之 旅 "} 
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3.4.4 ”多 环境 配置 


在 开发 Spring Boot 项 目的 时 候 ， 可 能 有 这 样 的 情况 ， 一 套 程序 需要 在 不 同 的 环境 中 发 布 ， 数 
据 库 配置 、 端 口 配 置 或 者 其 他 配置 各 不 相同 , 如 果 每 次 都 需要 修改 为 对 应 环境 配置 , 不 仅 耗费 人 力 ， 
而 且 特 别 容易 出 现 错误 ， 造 成 不 必要 的 麻烦 。 

通常 情况 下 ， 我 们 可 以 配置 多 个 配置 文件 ， 在 不 同 的 情况 下 进行 蔡 换 。 而 在 Spring Boot 项 目 
中 ， 我 们 新 建 几 个 配置 文件 ， 文 件 名 以 application- (name].properties 的 格式 ， 其 中 的 fname} 对 应 环 
境 标识 ， 比 如 : 

© application-dev.properties: 开发 环境 。 

* application-test.properties: 测试 环境 。 

* application-prod.properties: 生产 环境 。 


然后 ， 可 以 在 主 配 置 文件 Capplication.properties) 中 配置 spring.profiles.active 来 设置 当前 要 使 
用 的 配置 文件 。 比 如 ， 在 主 配置 文件 中 配置 本 次 指定 使 用 的 配置 文件 后 级 ， 配 置 内 容 如 代码 清单 
3-14 所 示 。 


代码 清单 3-14 application.properties 配置 文件 


spring.profiles.active=test 


创建 application-dev.properties 配置 文件 ， 在 文件 中 配置 端口 号 为 8081， 配 置 文件 内 容 如 代码 
清单 3-15 所 示 。 


代码 清单 3-15 application-devproperties 配置 文件 


server.port-8081 


(££ application-test.properties 配置 文件 ， 在 文件 中 配置 端口 号 为 8082， 配 置 文件 内 容 如 代码 
清单 3-16 所 示 。 


代码 清单 3-16 application-test.properties 配置 文件 


server.port-8082 


启动 项 目 或 者 打 成 JAR 包 形式 都 会 自动 读 取 对 应 配置 文件 ， 可 以 在 控制 台 看 到 启动 端口 号 为 
8082. 


3.4.5 自 定义 配置 文件 


前 面 介绍 了 多 环境 配置 文件 ， 我 们 也 可 以 使 用 自 定义 配置 文件 ， 比 如 新 建 一 个 testproperties， 
配置 文件 内 容 如 代码 清单 3-17 所 示 。 
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代码 清单 3-17 testproperties 配置 文件 


com.book.name-Spring Boot 2 实战 之 旅 
com.book .author= 杨 洋 


与 之 前 一 样 ， 新 建 一 个 javabean 来 读 取 配置 文件 。 新 建 一 个 ConfigBean， 在 类 上 加 上 注解 
@PropertySource(value = "classpath:test.properties")， 并 且 和 之 前 一 样 需要 加 入 @ConfigurationProperties 
(prefix = "com.book")， 实 体 类 代码 如 代码 清单 3-18 所 示 (省略 了 set, get 方法) 。 


代码 清单 3-18 ConfigBean 类 的 完整 内 容 


GComponent 
GPropertySource (value = "classpath:test.properties") 
GConfigurationProperties (prefix = "com.book") 
public class ConfigBean ( 

private String name; 

private String author; 


) 


同样 ， 在 TestController 中 注入 bean 并 且 创建 测试 方法 ， 内 容 如 代码 清单 3-19 所 示 。 


代码 清单 3-19  TestController 类 新 增 内 容 


GAutowired 
private ConfigBean configBean; 


QGetMapping ("test3") 
public ConfigBean test3()( 
return configBean; 


) 


使 用 浏览 器 访问 http://localhost:8080/test3， 可 以 看 到 显示 如 下 内 容 : 


("name":"Spring Boot 2 实战 之 旅 ", "author":" 杨 洋 "} 


3.5 ”使 用 页 面 模板 


在 Web 开发 过 程 中 , 前 后 端 交 互 是 一 件 不 可 避免 的 事情 。 接 下 来 我 们 学 习 Spring Boot 常用 的 
页 面 模 板 框架 。 


3.5.1 使 用 Thymeleaf 


Thymeleaf 是 当今 比较 流行 的 模板 框架 ， 并 且 是 Spring Boot 官方 推荐 使 用 的 模板 框架 。 本 小 
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节 介 绍 Spring Boot 框架 如 何 使 用 Thymeleaf， 并 且 会 对 Thymeleaf 框架 的 使 用 方法 进行 介绍 。 

首先 创建 项 目 ， 在 项 目 中 加 入 spring-boot-starter-thymeleaf 依赖 。 这 里 需要 提醒 的 是 ， 由 于 
Thymeleaf 对 HTML 的 校 验 特别 严格 ， 比 如 标签 没有 结束 等 可 能 会 对 不 熟悉 者 造成 未 知 的 困惑 ， 因 
此 我 们 还 需要 加 入 nekohtml 的 依赖 来 避免 这 个 “ 坑 ”。Thymeleaf 依赖 如 代码 清单 3-20 所 示 。 


代码 清单 3-20 Thymeleaf 项 目 -pom 文件 内 容 


«dependency» 
XgroupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-thymeleaf«/artifactId» 

</dependency> 

<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 

</dependency> 

<!-- 去 除 html 严格 校 验 --> 

«dependency» 
XgroupId»net.sourceforge.nekohtml«/groupId» 
X«artifactId»nekohtml«/artifactId» 
«version»1.9.22«/version» 

</dependency> 


完成 依赖 的 配置 之 后 ， 我 们 需要 在 配置 文件 中 对 Thymeleaf 进行 配置 ， 比 如 编码 格式 、 缓 存 设 
置 、 文 件 前 后 绥 等 。 配 置 文件 内 容 如 代码 清单 3-21 所 示 。 


代码 清单 3-21 Thymeleaf 项 目 -配置 文件 内 容 


## thymeleaf 缓存 是 否 开启 ， 开 发 时 建议 关闭 ， 否 则 更 改 页 面 后 不 会 实时 展示 效果 
spring.thymeleaf.cache-false 

## thymeleaf 编码 格式 

spring.thymeleaf.encoding-UTF-8 

## thymeleaf 对 HTML 的 校 验 很 严格 ， 用 这 个 去 除 thymeleat 严格 校 验 
spring.thymeleaf.mode-LEGACYHTML5 

HE thymeleaf 模板 文件 前 级 
spring.thymeleaf.prefix-classpath:/templates/ 

## thymeleaf 模板 文件 后 级 

spring.thymeleaf.suffix-.html 


到 这 里 ， 准 备 工作 已 经 完成 。 需 要 做 的 是 创建 一 个 Controller 和 HTML 进行 测试 。 新 建 一 个 
IndexController， 我 们 先 写 一 个 简单 的 路 由 跳 转 方法 并 且 传 一 个 字符 串 值 进行 测试 。IndexController 
内 容 如 代码 清单 3-22 所 示 。 
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代码 清单 3-22 Thymeleaf 项 目 -IndexController 的 内 容 


GController 
public class IndexController ( 


GGetMapping("/") 
public String index (ModelMap modelMap)( 
modelMap.addAttribute("msg", "Hello , Dalaoyang !"); 


return "index"; 


) 


然后 ， 在 src/mian/resources/templates 下 新 建 一 个 index.html. (需要 结合 配置 文件 中 
spring.thymeleaf prefix 的 配置 信息 存放 HTML) ， 使 用 th:text="${msg}" 来 接收 后 台 传 来 的 数据 。 
index.html 内 容 如 代码 清单 3-23 所 示 。 


代码 清单 3-23 Thymeleaf 项 目 -index.html 的 内 容 


<!DOCTYPE html» 
<html lang="en" xmlns:th-"http://www.w3.0rg/1999/xhtml"» 
<head> 
<meta charset="UTF-8"> 
<title>Title</title> 
</head> 
<body> 
<h1 th:text-"$(msg)"»«/hl» 
</body> 
</html> 


启动 项 目 ， 在 浏览 器 上 访问 http://localhost:8080， 可 以 看 到 有 如 下 显示 : 
Hello, Dalaoyang ! 


其 实 到 这 里 Spring Boot 整合 Thymeleaf 已 经 完成 ， 但 是 为 了 方便 后 面 章节 的 使 用 ， 笔 者 在 这 
里 再 介绍 一 下 Thymeleaf 模板 的 常用 语法 。 
th:text 设置 当前 元 素 的 文本 内 容 。 
th:value 设置 当前 元 素 的 值 。 
th:each ”循环 遍历 元 素 ， 一 般配 合 上 面 两 者 使 用 。 
th:attr 设置 当前 元 素 的 属性 。 
th:ifth:switch th:case th:unless ”用 作 条 件 判断 。 
th:insert th:replace th:incloud ”代码 块 引入 , 一 般 用 作 提 取 公 共 文件 ,或 者 引用 公共 静 态 文件 等 。 


当然 ，Thymeleaf 也 提供 了 一 些 内 置 方法 供 我 们 使 用 ， 比 如 : 
* tj 加 umbers 数字 方法 。 
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#dates 日 期 方法 。 
#calendars 日 历 方 法 。 
Hstings ”字符 囊 方法 。 
flists 集合 方法 。 
#maps 对象 方法 。 


关于 Thymeleaf 先 了 解 到 这 里 ， 后 面 的 章节 会 对 它 有 具体 的 实战 使 用 ， 这 里 就 不 再 袭 述 了 。 


3.5.2 ”使 用 FreeMarker 


刚刚 介绍 了 Thymeleaf 模板 ， 接 下 来 我 们 学 习 FreeMarker 模板 ， 无 论 是 语法 还 是 配置 等 ， 两 
者 都 有 很 多 相似 的 地 方 。 接 下 来 ， 我 们 学 习 Spring Boot 项 目 整合 FreeMarker 模板 。 
新 建 项 目 ， 在 项 目 中 加 入 Freemarker 依赖 ， 如 代码 清单 3-24 所 示 。 


代码 清单 3-24 FreeMarker 项 目 -pom 文件 内 容 


«dependency» 
XgroupId»org.springframework.boot«/groupId» 
XartifactlId»spring-boot-starter«/artifactId» 

«/dependency» 

<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-freemarker</artifactId> 

</dependency> 

<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 

«/dependency» 


接 下 来 配置 FreeMarker 模板 属性 ， 与 Thymeleaf 模板 配置 类 似 ， 唯 一 需要 注意 的 是 模板 文件 
后 绥 配 置 的 是 FTL 文件 。 配 置 文件 如 代码 清单 3-25 所 示 。 


代码 清单 3-25 FreeMarker 项 目 -配置 文件 内 容 


## freemarker 缓存 是 否 开启 

spring.freemarker.cache-false 

## freemarker 编码 格式 

spring.freemarker.charset-UTF-8 

## freemarker ERFA 
spring.freemarker.template-loader-path-classpath:/templates/ 
## freemarker 模板 文件 后 绥 ， 注 意 这 里 后 缀 名 是 . ftl 


spring.freemarker.suffix-.ftl 


接 下 来 ， 创 建 一 个 IndexController 进行 测试 ， 内 容 如 代码 清单 3-26 所 示 。 
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代码 清单 3-26 FreeMarker 项 目 -IndexController 文件 内 容 


(Controller 
public class IndexController ( 


GGetMapping("/") 

public String index(ModelMap modelMap) ( 
modelMap.addAttribute("msg", "Hi , Dalaoyang !"); 
return "index"; 


) 


TE src/resources/templates 下 新 建 index. 亿 (注意 文件 后 绥 )， 使 用 ${fmsg} 接 收 后 来 传送 的 数据 ， 
文件 内 容 如 代码 清单 3-27 所 示 。 


代码 清单 3-27 FreeMarker 项 目 -index. 仙 文件 内 容 


<!DOCTYPE html» 

<head> 
«meta charset-"UTF-8"» 
«title»Titlec/title» 

</head> 

<body> 

<h1>${msg}</h1> 

</body> 

</html> 


到 这 里 , 项 目 配 置 完成 。 启动 项 目 , 在 浏览 器 上 访问 http:/localhost:8080, 可 以 看 到 如 下 结果 : 
Hi, Dalaoyang ! 
接 下 来 介绍 FreeMarker 的 常用 语法 。 
(1) 通用 赋值 ，${xxx} 格 式 
”比如 后 台 返 回 键 值 aaa=string， 可 以 使 用 $ faaa?string}， 输 出 “Hi , Dalaoyang !”。 
e ”比如 后 台 返 回 键 值 aaa="2018-08-01 23:59"， 可 以 使 用 ${faaa2string("EEE,MMM d,yy")}, 输出 : 
星期 二 ， 八 月 14,18。 
e ”比如 后 台 返 回 键 值 aaa=false， 可 以 使 用 $f{faaa?string(" 是 "," 否 ")}， 输 出 : 否 。 
(2) 数值 赋值 ，#{xxx} 或 者 #{xxx;format} 格式 
后 者 format 可 以 是 以 下 格式 GEP X Rl Y 为 数字 ) : 


© mX 小 数 部 分 最 小 义 位 ， 比 如 后 台 返 回 值 aaa=3.782131， 可 以 使 用 #{x;m2}， 输 出 3.78。 
* MX 小 数 部 分 最 大 义 位 ， 比 如 后 台 返 回 值 aaa=3.782131， 可 以 使 用 #{fx:M3}， 输 出 3.782。 
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© mXMY 小 数 部 分 最 小 义 位 ,最 大 Y 位 ,比如 后 台 返 回 值 aaa=3.782131, 可 以 使 用 #{x;m1M3}， 
输出 3.782。 

(3) 常用 内 建 函 数 

html 对 字符 串 进 行 HTML 编码 。 

lower case. 字符 串 转 小 写 。 

upper_case 字符 串 转 大 写 。 

trim 去 前 后 空格 。 

size 获取 集合 元 素数 量 。 

int 获取 数字 部 分 。 

(4) 常用 指令 

ifelseif else 分 支 控制 语句 。 

list 输出 集合 数据 。 

import 导入 变量 。 

include 类 似 于 包含 指令 。 


关于 FreeMarker 模板 的 内 容 到 这 里 暂时 结束 了 ， 上 毕竟 这 是 一 本 关于 Spring Boot 的 书 ， 详 细 内 
容 可 以 参考 官方 文档 进行 系统 学 习 。 


3.5.8 ”使 用 传统 JSP 


虽然 Spring Boot 不 建议 使 用 JSP 作为 泻 染 页 面 ， 但 是 一 定 要 使 用 的 话 ， 也 是 可 以 的 。 
新 建 项 目 ， 加 入 JSP 对 应 的 依赖 和 JSTL 表达 式 依 赖 ， 并 且 需 要 注意 packaging 内 不 是 JAR 而 
是 WAR. pom 文件 代码 如 代码 清单 3-28 所 示 。 


代码 清单 3-28 JSP 项 目 -pom 文件 内 容 


<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 

</dependency> 

<dependency> 
XgroupId»org.springframework.boot«/groupId» 
«artifactlId»spring-boot-starter-test«/artifactId» 
Xscope»test«/scope» 

«/dependency» 

«dependency» 
XgroupId»org.apache.tomcat.embed«/groupId» 
XartifactId»tomcat-embed-jasper«/artifactlId» 
Xscope»provided«/scope» 


«/dependency» 
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<dependency> 
XgroupId»javax.servlet«/groupId» 
XartifactId»jstl«/artifactId» 
</dependency> 


然后 ， 需 要 在 src/mian 下 新 建 一 个 webapp 目录 ， 并 且 在 其 下 新 建 WEB-INF/jsp 文件 夹 ， 用 于 
放置 JSP 页 面 ， 结 构图 如 图 3-4 所 示 。 

接 下 来 , 我 们 进行 配置 文件 的 配置 , 主要 配置 JSP 页 面 文 件 前 级 和 后 级 , 基本 上 和 Thymeleaf、 
FreeMarker 类 似 ， 配 置 如 代码 清单 3-29 所 示 。 


v Bschapter3-5-3 


controller 


Controller 


图 3-4 JSP 项 目 启动 Log 


代码 清单 3-29 JSP 项目 -配置 文件 内 容 


spring.mvc.view.prefix-/WEB-INF/jsp/ 
spring.mvc.view.suffix-.jsp 


然后 创建 一 个 IndexController 文件 作为 跳 转 ， 完 整 内 容 如 代码 清单 3-30 所 示 。 


代码 清单 3-30 JSP 项 目 -IndexController 文 件 内 容 


GController 
public class IndexController { 
GGetMapping("/") 
public String index (Model model)(í 
model.addAttribute "name", "dalaoyang"); 
return "index"; 
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最 后 ， 在 创建 的 JSP 存放 文件 夹 下 创建 一 个 index.jsp， 其 中 ${name} 用 于 接收 后 人 台 传 来 的 值 。 
JSP 页 面 代码 如 代码 清单 3-31 所 示 。 


代码 清单 3-31 JSP 项 目 -index.jsp 文件 内 容 


<!DOCTYPE html> 

<html lang="en"> 

<head> 
<meta charset="UTF-8"> 
<title>Hello</title> 

</head> 

<body> 

Hello, $ {name} 

</body> 

</html> 


在 项 目 目录 下 使 用 命令 mvn spring-boot:run 启动 项 目 ， 在 浏览 器 上 访问 http://localhost:8888/， 
可 以 看 到 如 下 结果 : 


Hello,dalaoyang 


到 这 里 ，Spring Boot 使 用 JSP 介绍 完了 。 对 于 Spring Boot 还 有 很 多 模板 框架 可 以 使 用 ， 如 果 
不 是 必需 的 ， 那 么 建议 不 要 使 用 。 


3.6 使 用 WebJars 


在 开发 的 过 程 中 , 很 多 时 候 需要 结合 前 端 进行 开发 。 本 节 将 介绍 Spring Boot 框架 整合 WebJars 
进行 前 端 静态 JavaScript 和 CSS。 

作为 开发 者 ， 对 Bootstrap 和 jQuery 应 该 不 会 陌生 。 接 下 来 我 们 将 在 Spring Boot 项 目 中 引入 
WebJars， 对 应 二 者 的 JAR 进行 使 用 ,在 pom 文件 中 加 入 二 者 的 依赖 文件 ， 如 代码 清单 3-32 所 示 。 


代码 清单 3-32 ”WebJars 项 目 -pom 文件 内 容 


<!-- 引用 bootstrap --> 

«dependency» 
XgroupId»org.webjars«/groupId» 
XartifactId»bootstrap«/artifactlId» 
«version»3.3.7-1«/version» 

</dependency> 

<!-- 引用 jquery --> 

<dependency> 
XgroupId»org.webjars«/groupId» 
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<artifactId>jquery</artifactId> 
<version>3.1.1</version> 


</dependency> 


其 实 到 这 里 整合 完毕 了 ， 但 是 为 了 证 实 我 们 是 否 可 以 成 功 引 用 ， 在 src/main/recources/static X 
件 夹 下 新 建 index.html, 在 HTML 中 引入 刚刚 加 入 依赖 的 文件 .index.html 页 面 代码 如 代码 清单 3-33 
所 示 。 


代码 清单 3-33 WebJars 项 目 -index.html 文件 内 容 


<!DOCTYPE html> 

<html lang="en"> 

<head> 
<meta charset="UTF-8"> 
<title>Dalaoyang</title> 
<link rel-"stylesheet" href-"/webjars/bootstrap/3.3.7-1/css/ 

bootstrap.min.css" /» 

<script src-"/webjars/jquery/3.1.1/jquery.min.js"»«/script» 
«script src-"/webjars/bootstrap/3.3.7-1/js/bootstrap.min.js"» 
</script> 


</head> 
<body> 
<div class="container"><br/> 
<div class="alert alert-success"> 
<a href="#" class="close" data-dismiss="alert" aria-label="close"> x 
</a> 
Hello, <strong>Dalaoyang!</strong> 
</div> 
</div> 
</body> 
<script type="text/javascript"> 
alert ($ ('.close').attr('href')); 
</script> 
</html> 


在 HTML 页 面 中 ， 我 们 分 别 对 Bootstrap 和 jQuery 进行 了 引用 ， 使 用 Bootstrap 对 a 标签 进行 
了 样式 的 修饰 ， 使 用 jQuery 在 打开 页 面 时 利用 告警 输出 了 a 标签 的 href 值 。 启 动 项 目 ， 让 我 们 来 
证 实 一 下 ， 在 浏览 器 上 访问 http://localhost:8080， 如 图 3-5 所 示 。 

如 图 3-5 所 示 ， 可 以 看 到 之 前 的 操作 都 实现 了 。 其 实 WebJars 还 提供 了 很 多 其 他 的 依赖 ,具体 
使 用 可 以 查看 WebJars 官网 (官网 地 址 : https:Wwww.webjars.org/) 。 
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图 3-5 WebJars 项 目 访问 效果 图 


3.7 国际 化 使 用 


对 于 很 多 门户 网 站 ， 可 能 有 很 多 客户 来 源 于 其 他 国家 ， 这 时 就 需要 使 用 国际 化 来 进行 对 外 的 
交流 。 那 么 ， 在 Spring Boot 项 目 中 是 如 何 使 用 国际 化 的 呢 ? 

接 下 来 使 用 一 个 小 例子 介绍 Spring Boot 项 目 如何 运 用 国际 化 。 

本 节 使 用 的 依赖 文件 与 3.5 节 使 用 Thymeleaf 所 使 用 的 依赖 文件 以 及 配置 文件 完全 一 致 ， 这 里 
不 再 展示 。 

Spring Boot 在 默认 情况 下 是 支持 国际 化 使 用 的 ， 首 先 需要 在 src/main/resources 下 新 建国 际 化 
资源 文件 ， 这 里 为 了 举例 说 明 ， 分 别 创建 如 下 三 个 文件 : 


* messages.properties ( 默认 配置 )， 内 容 如 代码 清单 3-34 所 示 。 


代码 清单 3-34 ”国际 化 项 目 -默认 语言 配置 文件 内 容 


message = 欢迎 使 用 国际 化 CRU) 


* messages en US.properties (英文 配置 )， 内 容 如 代码 清单 3-35 所 示 。 


代码 清单 3-35 ”国际 化 项 目 -英文 配置 文件 内 容 


message = Welcome to internationalization (English) 


* messages zh CN properties (汉语 配置 )， 内 容 如 代码 清单 3-36 所 示 。 


代码 清单 3-36 ”国际 化 项 目 -汉语 配置 文件 内 容 


message = \u6b22\u8fce\u4f7f\u7528\u56fd\u9645\u5316\uff08\u4e2d\u6587\ 
uff09 


然后 就 到 了 国际 化 的 重头 戏 ， 需 要 进行 il8n 的 配置 ， 这 里 新 建 配 置 类 il8nConfig， 这 个 类 需 
要 继承 WebMvcConfigurerAdapter 类 。 其 中 ， 在 localeResolver() 方 法 中 设置 默认 使 用 的 语言 类 型 ， 
在 localeChangeInterceptor() 方 法 中 设置 识别 语言 类 型 的 参数 , 并 且 从 继承 类 中 实现 addInterceptors() 
方法 , 用 于 拦截 localeChangeInterceptor() 方 法 , 进而 实现 国际 化 。il8nConfig 类 代码 如 代码 清单 3-37 
所 示 。 


代码 清单 3-37 ”国际 化 项 目 - 


GConfiguration 
GEnableAutoConfiguration 
GComponentScan 
public class il8nConfig extends WebMvcConfigurerAdapter|( 
GBean 
public LocaleResolver localeResolver() ( 
SessionLocaleResolver slr - new SessionLocaleResolver(); 
// 默认 使 用 的 语言 
Slr.setDefaultLocale (Locale.US); 
return slr; 


GBean 

public LocaleChangeInterceptor localeChangeInterceptor() ( 
LocaleChangeInterceptor lci = new LocaleChangeInterceptor(); 
// 参数 名 ， 用 于 区 别 使 用 的 语言 类 型 
lci.setParamName ("lang"); 
return lci; 


GOverride 
public void addInterceptors (InterceptorRegistry registry) ( 
registry.addInterceptor (localeChangeInterceptor ()); 


) 


改造 默认 生成 的 启动 类 ， 在 类 上 加 入 SpringMVC tff Controller, YE X MessageSource 类 获 
取 国际 化 资源 ， 并 且 创 建 方法 返回 资源 文件 对 应 的 数据 ， 返 回 到 前 台 。 新 增 代 码 如 代码 清单 3-38 
所 示 。 


代码 清单 3-38 ”国际 化 项 目 -启动 类 新 增 代码 文件 内 容 


GGetMapping("/") 
public String hello (Model model)( 
Locale locale - LocaleContextHolder.getLocale(); 
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model.addAttribute ("message", messageSource.getMessage ("message", null, 
locale)); 
return "index"; 


) 


TE src/main/resources/template 下 新 建 ndex.html， 在 页 面 中 创建 两 个 按钮 ， 单 击 按钮 切换 语言 。 
index.html 页 面 代码 如 代码 清单 3-39 所 示 。 


代码 清单 3-39 国际 化 项 目 -index.html 文件 内 容 


<!DOCTYPE html» 
<html lang="en" xmlns:th-"http://www.w3.0rg/1999/xhtml"» 
<head> 
<meta charset-"UTF-8"» 
«title»Titlec/title» 
</head> 
<body> 
<a href-"/?lang-en US">English (US) </a> 
«a href="/?1ang=zh_CN"> 简 体 中 文 </a></br> 
<p><label th:text="#{message}"></label></p> 
</body> 
</html> 


启动 项 目 ， 在 浏览 器 上 访问 http:Wlocalhost:8080/， 显 示 的 内 容 如 图 3-6 所 示 。 


eoe «x D 


English(US) 简体 中 文 


欢迎 使 用 国际 化 中 文 ) 


图 3-6 国际 化 项 目 ， 中 文 显示 效果 
单 击 页 面 中 的 English(US) 英 文 按钮 ， 显 示 的 内 容 如 图 3-7 所 示 。 


e^e < D 


English(US) 简体 中 文 


Welcome to internationalization (English) 


图 3-7 ”国际 化 项 目 ， 英 文 显示 效果 
这 时 你 可 能 会 有 一 个 疑问 ， 为 什么 没有 显示 默认 的 配置 文件 ? 这 是 因为 在 发 送 HTTP 请 求 的 
时 候 , 浏览 器 会 根据 你 的 请 求 头 判断 区 域 而 进行 系统 设 定 。 那 么 问题 来 了 ， 怎 么 才 会 使 用 到 默认 的 
配置 文件 呢 ? 其 实 很 简单 ， 浏 览 器 根据 系统 区 域 在 你 的 程序 中 找 不 到 语言 时 ， 就 会 使 用 默认 配置 ， 
比如 ， 删 除 项 目 中 英文 和 中 文 的 配置 ， 只 留 下 一 个 默认 配置 ， 重 启 项 目 ， 再 次 访问 
http://localhost:8080/， 显 示 的 内 容 如 图 3-8 所 示 。 
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eoe < 田 


English(US) 简体 中 文 
欢迎 使 用 国际 化 RA) 


图 3-8 国际 化 项 目 ， 默 认 显示 效果 


这 时 就 可 以 看 到 默认 配置 ， 而 且 即 使 你 单 击 上 面 的 两 个 切换 语言 的 按钮 ， 也 不 会 有 所 改变 ， 
因为 应 用 内 现在 只 有 这 一 种 配置 。 


3.8 文件 的 上 传 和 下 载 


3.7 节 介绍 了 利用 Thymeleaf 模板 进行 国际 化 的 使 用 ， 本 节 将 使 用 FreeMarker 模板 进行 文件 的 
上 传 和 下 载 ， 对 前 面 Spring Boot 使 用 模板 框架 进行 一 个 回顾 。 

创建 项 目 、 项 目 依 赖 和 配置 文件 与 3.5 节 使 用 FreeMarker 一 致 。 在 配置 完 依赖 后 , 在 src/main/ 
resources/templates 下 新 建 一 个 index.ftl 文件 ， 文 件 内 分 别 利用 表单 提交 的 方式 写 了 两 个 表单 ， 用 
于 单个 上 传 和 批量 上 传 ， 并 且 使 用 超 链接 的 方式 提供 了 一 个 下 载 方法 ， 代 码 如 代码 清单 3-40 所 示 。 


代码 清单 3-40 上传 和 下 载 项 目 -index.ft 文件 内 容 


<!DOCTYPE html» 

<html lang="en"> 

<head> 
«meta charset-"UTF-8"» 
«title»$(msg)«/title» 

</head> 

<body> 

<p> 单 文件 上 传 </p> 

<form action="upload" method="POST" enctype="multipart/form-data"> 
文件 : <input type="file" name="file"/> 
<input type="submit"/> 

</form> 

<hr/> 

<p> 文 件 下 载 </p> 

<a href="download"> 下 载 文件 </a> 

<hr/> 

<p> 多 文件 上 传 </p> 

<form action="batch" method="POST" enctype="multipart/form-data"> 
<p> 文 件 1: «input type-"file" name="file"/></p> 
<p> 文 件 2: «input type-"file" name="file"/></p> 
<p><input type="submit" value=" 上 传 "/></p> 

</form> 
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</body> 
</html> 


更 改 启动 类 ， 在 类 上 添加 注解 @Controller， 新 建 index 方法 用 于 跳 转 ， 向 页 面 传 值 msg， 方 法 
如 代码 清单 3-41 所 示 。 


代码 清单 3-41 ”上传 和 下 载 项 目 -启动 类 新 增 文件 内 容 


@GetMapping ("/") 

public String index (ModelMap modelMap) { 
modelMap.addAttribute ("msg"，" 文 件 上 传 下 载 ") ; 
return "index"; 


} 


接 下 来 创建 一 个 FileController 用 于 文件 上 传 和 下 载 测试 ， 具 体 方法 如 下 : 


CD 单个 上 传 方法 。 可 以 根据 页 面 上 使 用 的 input 标签 的 name 值 获取 对 应 内 容 , 因为 是 文件 ， 
所 以 可 以 使 用 MultipartFile 对 象 来 接收 文件 , 由 于 只 是 简单 测试 , 因此 利用 File 类 自 带 的 transferTo 
方法 直接 将 文件 存 入 对 应 存储 位 置 。 

(2) 批量 上 传 方法 。 获 取 页 面 内 容 的 方式 和 单个 上 传 方法 大 致 相同 ， 不 同 的 是 取得 文件 后 ， 
这 里 使 用 BufferedOutputStream 流 来 进行 上 传 ， 如 果 对 Java 流 不 太 了 解 ， 那么 可 以 学 习 一 下 相关 流 
的 知识 ， 注 意 在 使 用 结束 后 不 要 忘记 关闭 流 。 

(3) 下 载 方法 。 本 文中 例子 只 是 对 固定 位 置 的 文件 进行 下 载 ， 在 实际 应 用 中 ， 可 以 根据 具体 
情况 进行 修改 。 同 样 ， 下 载 方法 也 是 使 用 流 的 方式 ， 并 且 响 应 到 浏览 器 。 


FileController 类 代码 如 代码 清单 3-42 所 示 。 


代码 清单 3-42 上传 和 下 载 项 目 -FileController 文件 内 容 


GRestController 
public class FileController ( 


private static final String filePath-"/Users/dalaoyang/Downloads/"; 
private static final Logger log - LoggerFactory.getLogger 
(FileController.class); 


GRequestMapping (value = "/upload") 
public String upload(GRequestParam("file") MultipartFile file) ( 
try ( 
if (file.isEmpty()) ( 
return "文件 为 空 "; 
} 
// 获取 文件 名 


String fileName = file.getOriginalFilename(); 
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1og.info (" 上 传 的 文件 名 为 : " + fileName); 
// 设置 文件 存储 路 径 
String path = filePath + fileName; 
File dest - new File(path); 
// 检测 是 否 存在 目录 
if (!dest.getParentFile().exists()) ( 
dest.getParentFile().mkdirs();// 新 建文 件 夹 

} 
file.transferTo(dest);// 文件 写 入 
return "上 传 成 功 "; 

} catch (IllegalStateException e) { 
e.printStackTrace(); 

) catch (IOException e) ( 
e.printStackTrace(); 

b 

return "上 传 失 败 "; 


GPostMapping ("/batch") 
public String handleFileUpload(HttpServletRequest request) ( 
List«MultipartFile» files = ((MultipartHttpServletRequest) request). 
getFiles ("file"); 
MultipartFile file - null; 
BufferedOutputStream stream - null; 
for (int i = 0; i < files.size(); ++i) { 
file - files.get(i); 
if (!file.isEmpty()) ( 
try ( 
byte[] bytes = file.getBytes(); 
Stream - new BufferedOutputStream(new FileOutputStream( 
new File(filePath + file.getOriginalFilename()))); 
// 设 置 文件 路 径 及 名 字 
stream.write (bytes); H RA 
stream.close(); 
) catch (Exception e) { 
stream - null; 
return "第 "+ i + " 个 文件 上 传 失 败 ==> " 
+ e.getMessage(); 
} 
} else | 
return "第 " + i 


+ " 个 文件 上 传 失败 ， 因 为 文件 为 空 "; 


第 3 章 Spring Boot 的 Web 之 旅 


| 


47 


H 
return "上 传 成 功 "; 


@GetMapping("/download") 
Public String downloadFile( HttpServletResponse response) { 


String fileName = "dalaoyang.jpg"; // 文件 名 
if (fileName !- null) ( 
// 设 置 文件 路 径 


File file = new File(filePath+fileName) 7 
if (file.exists()) ( 
response.setContentType ("application/force-download"); 
// 设置 强制 下 载 不 打开 
response.addHeader ("Content-Disposition", "attachment; 
fileName-" 4 fileName); // 设置 文件 名 
byte[] buffer = new byte[1024]; 
FileInputStream fis - null; 
BufferedInputStream bis - null; 


try ( 
fis - new FileInputStream(file); 
bis - new BufferedInputStream(fis); 


OutputStream os - response.getOutputStream(); 
int i = bis.read(buffer); 
while (i != -1) ( 
os.write(buffer, 0, i); 
i = bis.read(buffer); 
) 
return "下 载 成 功 "; 
} catch (Exception e) { 
e.printStackTrace(); 
) finally ( 
if (bis !- null) ( 
try ( 
bis.close(); 
) catch (IOException e) ( 
e.printStackTrace(); 


) 
if (fis !- null) ( 
try ( 
fis.close(); 
) catch (IOException e) ( 
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e.printStackTrace(); 


H 
H 
return "FRAK"; 


} 


本 节 只 是 进行 简单 的 上 传 和 下 载 ， 当 然 上 述 方法 并 不 适用 于 大 文件 ， 只 是 对 使 用 FreeMarker 
模板 进行 一 个 回顾 。 


3.9 小 结 


本 章 从 Spring Boot 使 用 传统 Spring MVC 模式 到 Spring 5 以 后 的 WebFlux 开始 介绍 ， 紧 接着 
介绍 配置 文件 、 热 部 署 等 实用 的 内 容 , 最 后 介绍 模板 框架 ,让 读者 可 以 在 本 章 由 浅 入 深 地 学 习 Spring 
Boot 关 于 Web 方面 的 使 用 ,对 Spring Boot 关于 Web 方面 的 内 容 有 深刻 的 认识 ， 并 能 够 运用 自如 。 


Spring Boot 的 数据 库 之 旅 


数据 库 是 存储 管理 数据 的 仓库 ， 是 开发 一 个 应 用 的 必要 因素 。 其 实 从 某 种 程度 上 来 说 ， 数 据 
库 是 实现 一 个 系统 的 根本 ， 甚 至 有 时 我 们 可 以 理解 为 : 应 用 实质 上 就 是 展示 数据 库 、 存 储 数据 库 数 
据 等 一 系列 对 数据 库 的 操作 ， 所 以 学 习 数 据 库 操作 对 我 们 来 说 尤其 重要 。 本 章 将 学 习 Spring Boot 
对 数据 库 的 操作 ， 让 我 们 开启 Spring Boot 的 数据 库 之 旅 。 


4.1 使 用 数据 库 


数据 库 分 为 两 种 ， 即 关系 型 数据 库 和 非 关系 型 数据 库 。 关 系 型 数据 库 是 指 通过 关系 模型 组 织 
数据 的 数据 库 ， 并 且 可 以 利用 外 键 等 保持 一 致 性 ; 而 非 关 系 型 数据 库 其 实 不 像 是 数据 库 ， 更 像 是 一 
种 以 key-value 模式 存储 对 象 的 结构 。 本 节 来 了 解 Spring Boot 如 何 使 用 数据 库 ， 以 依赖 和 配置 文件 
为 例 ， 后 续 章 节 会 对 数据 库 进 行 具体 使 用 。 


4.1.1 使 用 MySQL 数据 库 


MySQL 数据 库 〈( 官 网 地 址 : https://www.mysgl.com) 是 一 种 
关系 型 数据 库 ， 由 瑞典 的 一 家 公司 开发 ， 现 在 是 Oracle 公司 旗下 N 


的 产品 。MySQL 使 用 C 和 C++ 语言 开发 ， 提 供 多 种 存储 引擎 ， 提 

供 多 种 连接 途径 ， 例 如 ODBC. JDBC, TCP/IP 等 ， 并 且 支 持 多 线 

程 ， 是 当今 最 流行 的 数据 库 之 一 ， 并 且 免 费 提供 给 开发 者 使 用 。 MySQL: 
MySQL 数据 库 的 LOGO 使 用 一 个 海豚 作为 标记 ， 如 图 4-1 所 示 。 

海豚 标志 的 名 字 叫 sakila， 它 是 由 MySQL 的 创始 人 从 用 户 在 “ 海 R41 MySQL 数据库 LOGO 
豚 命 名 ”的 竞赛 中 建议 的 大 量 名 字 表 中 选 出 的 。 
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同时 ，MySQL 数据 库 是 一 个 高 性 能 的 数据 库 ， 并 且 支 持 多 种 开发 语言 ， 如 C、C++、Python、 
Java, Perl, PHP, Eiffel, Ruby 和 Tcl 等。 并且，MySQL 支持 大 型 的 数据 库 ， 可 以 处 理 拥有 上 千 
万 条 记录 的 大 型 数据 库 。MySQL 提供 多 种 存储 引擎 及 索引 格式 , 采用 GPL 协议 , 如 果 有 需要 的 话 ， 
可 以 根据 场景 修改 源码 来 开发 自己 的 MySQL 系统 。 

在 Spring Boot 中 使 用 MySQL 很 简单 ， 大 致 分 为 两 步 : 


(1) 在 pom 文件 中 加 入 依赖 ， 如 代码 清单 4-1 所 示 。 


代码 清单 4-1 MySQL 依赖 代码 


<dependency> 
<groupId>mysql</groupId> 
<artifactId>mysql-connector-java</artifactId> 
<scope>runtime</scope> 

</dependency> 


(2) 在 配置 文件 中 配置 数据 库 信 息 ， 如 代码 清单 4-2 所 示 。 


代码 清单 4-2 ”Mysql 配置 文件 代码 


## 数 据 库 地 址 

spring.datasource.url-jdbc:mysql://localhost:3306/test?characterEncoding- 
utf8&useSSL-false 

## 数 据 库 用 户 名 

spring.datasource.username-root 

## 数 据 库 密码 

spring.datasource.password-root 

## 数 据 库 驱动 


spring.datasource.driver-class-name-com.mysql.jdbc.Driver 


4.1.2 使 用 SQL Server 数据 库 


SQL Server 是 微软 公司 推出 的 关系 型 数据 库 〈 富 网 地 址 : https://www.microsoft.com/zh-cn/sql- 
server) ， 最 初 是 由 Microsoft, Sybase 和 Ashton-Tate 三 家 公司 共同 开发 的 ， 于 1988 年 推出 了 第 一 
个 OS/2 版 本 。 在 Windows NT 推出 后 , Microsoft 与 Sybase 在 SQL Server. 的 开发 上 就 分 道 扬 镰 了 。 
Microsoft 将 SQL Server 移植 到 Windows NT 系统 上 ， 专 注 于 开发 推广 SQL Server 的 Windows NT 
版 本 ; Sybase WEEET SQL Server 在 UNIX 操作 系统 上 的 应 用 。SQL Server 与 MySQL 有 很 多 
相似 的 地 方 ， 可 以 跨越 多 种 平台 使 用 , 并 且 提 供 了 更 安全 可 靠 的 存储 功能 ， 方 便 构 建 高 可 用 性 能 的 
应 用 程序 。SQL Server 数据 库 的 LOGO 使 用 微软 公司 一 贯 的 风格 ， 如 图 4-2 所 示 。 


Pg SQL Server 


42 SQL Server 数据 库 的 LOGO 
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SQL Server 数据 库 同样 提供 了 很 多 优点 ， 如 易 用 性 、 适 合 分 布 式 组 织 的 可 伸缩 性 、 用 于 决策 
支持 的 数据 仓库 功能 、 与 许多 其 他 服务 器 软件 紧密 关联 的 集成 性 、 良 好 的 性 价 比 等 。 但 是 相 较 于 
MySQL， 其 有 一 定 的 缺点 ， 如 局 限 性 (只 能 运行 在 Windows £t E) 、 当 连接 数 过 高 时 性 能 不 够 
稳定 等 。 

Spring Boot 使 用 SQL Server 数据 库 也 很 简单 ， 分 为 两 步 : 


(1) 在 pom 文件 中 加 入 依赖 ， 如 代码 清单 4-3 所 示 。 


代码 清单 4-3 SQL Server 依赖 代码 


<dependency> 
<groupId>com.microsoft.sqlserver</groupId> 
<artifactId>mssql-jdbc</artifactId> 
<scope>runtime</scope> 

</dependency> 


(2) 在 配置 文件 中 配置 数据 库 信 息 ， 如 代码 清单 4-4 所 示 。 


代码 清单 4-4 SQL Serer 配置 文件 代码 清单 


## 数 据 库 地 址 

spring.datasource.url-jdbc:sqlserver://192.168.16.218:1433;databaseName-d 
ev btrpawn 

## 数 据 库 用 户 名 

spring.datasource.username-sa 

## 数 据 库 密码 

spring.datasource.password-p8sswÜrd 

## 数 据 库 驱 动 

spring.datasource.driver-class-name-com.microsoft.sqlserver.jdbc.SQLServe 
rDriver 


4.1.3 ”使 用 Oracle 数据 库 


Oracle Database (官网 地 址 : https://www.oracle.com). 又 名 
Oracle RDBMS， 简 称 Oracle。Oracle 是 甲骨 文公 司 的 一 款 关 系数 
据 库 管理 系统 ， 它 在 数据 库 领 域 一 直 处 于 领先 地 位 。Oracle 数据 
库 系 统 是 目前 世界 上 流行 的 关系 数据 库 管理 系统 ， 系 统 可 移植 性 
好 、 使 用 方便 、 功 能 性 强 ， 适 用 于 各 类 大 、 中 、 小 、 微 机 环境 。 
它 是 一 种 高 效率 的 、 可 靠 性 好 的 、 适 应 高 吞吐 量 的 数据 库 解 决 方 
案 。Oracle 数据 库 的 LOGO 很 简单 ， 就 是 Oracle 公司 的 图 标 ， 如 
图 4-3 所 示 。 图 4.3 Oracle 数据 库 的 LOGO 

Spring Boot 使 用 Oracle 数据 库 需 要 自行 下 载 依赖 JAR 包 , 中 央 仓 库 没有 对 应 的 JAR 包 , 引入 
JAR 之 后 在 配置 文件 中 加 入 如 下 配置 ， 如 代码 清单 4-5 所 示 。 
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代码 清单 4-5 Oracle 配置 文件 


spring.datasource.driver-class-name-oracle.jdbc.driver.OracleDriver 
spring.datasource.url-jdbc:oracle:thin:(1localhost:1521:0rcl 
spring.datasource.username-dalaoyang 
spring.datasource.password-dalaoyangl23 


这 里 延伸 一 个 关于 Maven 的 小 技巧 ， 主 要 介绍 常用 的 导入 Jar 的 方式 : 

1. 命令 行 方 式 

命令 行 的 方式 比较 简单 ， 比 如 我 们 要 导入 在 本 地 下 载 文件 夹 中 的 ojdbc8jar 到 本 地 仓库 ， 如 代 
码 清单 4-6 所 示 。 


代码 清单 4-6 ”命令 行 导入 JAR 


mvn install:install-file -Dfile-/Users/dalaoyang/Downloads/ojdbc8.jar 
-DgroupId-com.oracle -DartifactlId-oracle -Dversion-8.0.0 -Dpackaging-jar 


其 中 : 

e -Dfile: 文件 位 置 。 

* -Dgroupld: 依赖 的 groupld. 

* -DartifactId: 依赖 的 artifactId。 

* -Dversion: 依赖 的 版 本 号 。 

© -Dpackaging: 什么 类 型 的 文件 (这 里 使 用 Jar). 


执行 命令 后 如 图 4-4 所 示 。 


44 命令 行 导入 Jar 执行 图 
然后 我 们 查看 一 下 本 地 Maven 仓库 ， 也 可 以 找到 刚刚 上 传 的 Jar， 如 图 4-5 所 示 。 
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4-5 查看 本 地 Maven 仓库 
导入 后 我 们 就 可 以 在 本 地 正常 引用 刚刚 导入 的 Jar 文 件 了 。 
2. 引用 本 地 Jar 
命令 行 的 方式 看 起 来 似乎 有 一 些 麻烦 ， 不 过 不 要 紧 ，Spring Boot 提供 了 引用 本 地 Jar 文件 的 方 


式 ， 比 如 在 本 地 项 目 src/lib 目录 下 有 一 个 ojdbc8.jar, 我 们 只 需要 在 pom.xml 文件 中 配置 如 下 内 容 ， 
如 代码 清单 4-7 所 示 。 


代码 清单 4-7 POM 引入 本 地 Jar 


<dependency> 
<groupId>com.oracle</groupId> 
<artifactId>oracle</artifactId> 
<version>8.0.0</version> 
<scope>system</scope> 
«systemPath»$(project.basedir]/src/lib/ojdbc8.jar«/systemPath» 
</dependency> 


配置 后 重新 导入 Jar， 如 图 4-6 所 示 。 


ii Dependencies 


oot-starter:2.1.4. RELEASE 
er-test:2.1.4.RELEASE 


图 4-6 查看 本 地 Maven 仓库 


可 以 看 到 ， 这 种 方式 在 本 地 也 可 以 引用 本 地 Jar 文件 。 不 过 有 一 个 问题 ， 这 种 方式 在 使 用 Spring 
Boot 项 目 打 Jar 包 的 时 候 并 没有 将 我 们 的 本 地 Jar 导入 ， 那 么 怎么 解决 呢 ? 

其 实 Spring Boot 提供 了 插件 解决 这 个 问题 ， 我 们 只 需要 在 pom.xml 文件 中 引入 如 下 插件 即 可 解 
决 ， 如 代码 清单 48 所 示 。 


代码 清单 4-8 POM 引入 Spring Boot 打包 本 地 Jar 插件 


<plugin> 
XgroupId»org.springframework.boot«/groupId» 
XartifactlId»spring-boot-maven-plugin«/artifactId» 
«configuration» 
XincludeSystemScope»^true«/includeSystemScope» 
«/configuration» 
X/plugin» 
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3. 使 用 Nexus 平台 导入 
这 里 所 说 的 Nexus 平台 就 是 本 地 私服 ,与 Maven 中 央 仓 一 致 。 访 问 私 服 地 址 并 登录 ， 如 图 4-7 


所 示 。 
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图 4-7 查看 本 地 Nexus 平台 
这 里 以 上 传 第 三 方 Jar 为 例 ， 单 击 Artifact Upload 按钮 ， 如 图 4-8 所 示 。 
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图 4-8 查看 本 地 Maven 仓库 -Artifact Upload 


在 GAV Definition 下 拉 框 中 选择 GAV Parameters， 如 图 4-9 所 示 。 
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Nexus Repository Manager OSS 


图 4-9 查看 本 地 Maven 仓库 -GAV Parameters 
分 别 填 入 Group, Artifact, Version 并 且 选 择 合适 的 Packaging， 设 置 完成 后 单 击 Select Artifact(s) 
for Upload 按钮 ， 选 择 Jar 文件 , 都 完成 后 单 击 左 下 方 的 Add Artifact 按钮 ， 最 后 单 击 Upload Artifact(s) 
完成 上 传 ， 结 果 与 使 用 命令 行 一 致 。 


4.1.4 1H MongoDB 数据 库 


MongoDB (官网 地 址 : https://www.mongodb.com) 是 一 种 非 关 系 型 数据 库 ， 它 是 一 个 基于 分 
布 式 文件 存储 的 数据 库 。MongoDB 由 C++ 语 言 编写 ， 有 高 性 能 、 容 易 部 署 等 优点 ， 官 网 的 介绍 
如 下 : 

MongoDB (来 自 于 英文 单词 Humongous， 中 文 含义 为 “庞大 ”) 是 可 以 应 用 于 各 种 规模 的 企 
业 、 各 个 行业 以 及 各 类 应 用 程序 的 开源 数据 库 。 作 为 一 个 适用 于 敏捷 开发 的 数据 库 ，MongoDB 的 
数据 模式 可 以 随 着 应 用 程序 的 发 展 而 灵活 地 更 新 。 与 此 同时 , 它 为 开发 人 员 提 供 了 传统 数据 库 的 功 
能 : 二 级 索引 、 完 整 的 查询 系统 以 及 严格 一 致 性 等 。MongoDB 能 够 使 企业 更 加 具有 敏捷 性 和 可 扩 
展 性 ， 各 种 规模 的 企业 都 可 以 通过 使 用 MongoDB 来 创建 新 的 应 用 ， 提 高 与 客户 之 间 的 工作 效率 、 
加 快 产品 上 市 时 间 以 及 降低 企业 成 本 。 

MongoDB 是 专 为 可 扩展 性 、 高 性 能 和 高 可 用 性 而 设计 的 数据 库 。 它 可 以 从 单 服务 器 部 署 扩展 
到 大 型 、 复 杂 的 多 数据 中 心 架构 。 利 用 内 存 计算 的 优势 ，MongoDB 能 够 提供 高 性 能 的 数据 读 写 操 
作 。MongoDB 的 本 地 复制 和 自动 故障 转移 功能 使 你 的 应 用 程序 具有 企业 级 的 可 靠 性 和 操作 灵活 性 。 

MongoDB 数据 库 的 LOGO 使 用 一 个 绿色 叶子 和 mongoDB 
英文 字母 组 成 ， 如 图 4-10 所 示 。 T 

Spring Boot 使 用 MongoDB 数据 库 很 简单 ， 分 为 两 步 : mongoDB 


(1) 在 pom 文件 加 入 依赖 ， 如 代码 清单 4-9 所 示 。 图 4-10 MongoDB 数据 库 LOGO 
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代码 清单 4-9 MongoDB 依赖 代码 


<dependencies> 
<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-data-mongodb</artifactId> 
</dependency> 
</dependencies> 


(2) 在 配置 文件 中 加 入 MongoDB 配置 ， 如 代码 清单 4-10 所 示 。 


代码 清单 4-10 MongoDB 配置 文件 


HEED 

spring.data.mongodb.uri-mongodb://localhost:27017/test 

HATI 

#spring.data.mongodb.uri=mongodb://root (userName) : root (password) @localhos 
t (ip 地 址 ) :27017 (端口 号 ) /test (collections/ 数 据 库 ) 


4.1.5 使 用 Neo4j 数据 库 


Neo4j〔 官 网 地 址 : https://neo4j.com/) 是 一 种 非 关系 E 
型 数据 库 ， 它 是 一 种 图 形 数据 库 , 将 结构 化 数据 存储 在 网 ec riec»zjiJ 
络 上 而 不 是 表 中 , 同时 可 以 享受 到 事务 特性 等 优势 .Neo4j 
数据 库 的 LOGO 如 图 4-11 Bras. 

Spring Boot 使 用 Neo4j 数据 库 很 简单 ， 分 为 两 步 : 


A) 在 pom 文件 中 加 入 依赖 ， 如 代码 清单 4-11 所 示 。 


代码 清单 4-11 Neo4j 依赖 代码 


«dependency» 


图 4-11 Neo4j 数据 库 的 LOGO 


XgroupId»org.springframework.boot«/groupId» 
«artifactld»spring-boot-starter-data-neo4j«/artifactId» 
«/dependency» 


(OD 在 配置 文件 中 加 入 配置 ， 如 代码 清单 4-12 所 示 。 


代码 清单 4-12 ”Neo4j 配置 文件 代码 


spring.data.neo4j.uri-http://localhost:7474 
spring.data.neo4j.username-dalaoyang 
spring.data.neo4j.password-dalaoyangli23 
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4.1.6 ”使 用 Redis 数据 库 


Redis〈 官 网 地 址 : https://redis.io/) 是 一 种 非 关系 型 数据 库 ， 
使 用 ANSI C 语言 开发 ， 是 一 种 Key-Value 模式 的 数据 库 ， 支 持 多 SZ redis 
种 value 类 型 ， 如 string (字符 串 ) ~ list (链表 ) ~ set (集合 ) ~ 
zset (sorted set， 有 序 集合 ) 和 hash〔〈 哈 希 类 型 ) 。 如 图 4-12 所 示 
是 Redis 数据 库 的 LOGO。 

对 于 Redis 来 说 ， 我 们 可 能 对 它 使 用 的 更 多 的 是 缓存 ， 毕 竟 它 可 以 高 效 地 对 数据 进行 操作 。 其 
实 它 还 具备 很 多 功能 ， 比 如 消息 队列 、 发 布 、 订 阅 消息 等 。 另 外 ， 它 提供 了 持久 化 的 方式 ， 在 后 续 
章节 有 详细 介绍 ， 这 里 先 简单 对 依赖 和 配置 进行 介绍 。Spring Boot 使 用 Redis 数据 库 分 为 两 步 : 


(1) 在 pom 文件 中 加 入 依赖 ， 如 代码 清单 4-13 所 示 。 


4-2. Redis 数据 库 的 LOGO 


代码 清单 4-13 Redis 依赖 代码 


<dependency> 
XgroupId»org.springframework.boot«/groupId» 
XartifactlId^spring-boot-starter-data-redis«/artifactId» 
</dependency> 


(2) 在 配置 文件 中 加 入 配置 ， 如 代码 清单 4-14 所 示 。 


代码 清单 4-14 Redis 配置 文件 代码 
+ Redis 数据 库 索引 (默认 为 0) 


spring.redis.database-0 

* Redis 服务 器 地 址 
spring.redis.host-localhost 

+ Redis 服务 器 连接 端口 
spring.redis.port-6379 

# Redis 服务 器 连接 密码 (默认 为 空 ) 
spring.redis.password= 

# 连 接 池 最 大 连接 数 〈 使 用 负 值 表示 没有 限制 
spring.redis.pool.max-active-8 

# 连接 池 最 大 阻塞 等 待 时 间 使 用 负 值 表示 没有 限制 ) 
spring.redis.pool.max-wait=-1 

# 连接 池 中 的 最 大 空闲 连接 
spring.redis.pool.max-idle-8 

# 连接 池 中 的 最 小 空闲 连接 
spring.redis.pool.min-idle-0 

# 连接 超时 时 间 (毫秒 ) 


spring.redis.timeout=0 
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4.1.7 ”使 用 Memcached 数据 库 


Memcached (官网 地 址 : http://memcached.org/) 是 一 个 高 性 能 的 分 布 式 内 存 对 象 缓存 系统 ， 
用 于 动态 Web 应 用 以 减轻 数据 库 负载 。 它 通过 在 内 存 中 缓存 数据 和 对 象 来 减少 读 取 数 据 库 的 次 数 ， 
从 而 提高 动态 、 数 据 库 驱 动 网 站 的 速度 。Memcached 基于 一 个 存储 键 / 值 对 的 hashmap。 其 守护 进 
FE (daemon) 是 用 C 写 的, 但 是 客户 端 可 以 用 任何 语言 来 编写 ， 
并 通过 Memcached 协议 与 守护 进程 通信 。Memcached 数据 库 
的 LOGO 如 图 4-13 所 示 。 

在 后 续 有 专门 的 章节 介绍 Memcached, 这 里 和 Redis 一 样 ， 
只 是 对 依赖 和 配置 进行 介绍 。Spring Boot 使 用 Memcached Xt 
据 库 分 为 两 步 : 


(D YE pom 文件 中 加 入 依赖 ， 如 代码 清单 4-15 所 示 。 。 图 413 Memcached 数据 库 的 LOGO 


代码 清单 4-15 ”Memcached 依赖 代码 


«dependency» 
XgroupId»net.spy«/groupId» 
«artifactId»spymemcached«/artifactId» 
«version»2.12.2«/version» 
«/dependency» 


(2) 在 配置 文件 中 加 入 配置 ， 如 代码 清单 4-16 所 示 。 


代码 清单 4-16 ”Memcached 配置 文件 代码 


# memcached 地 址 
memcache.ip-localhost 
# memecached 端口 
memcache.port-11211 


本 节 介绍 了 Spring Boot 对 关系 型 数据 库 及 非 关 系 型 数据 库 的 使 用 ， 只 是 介绍 了 关于 配置 和 依 
赖 ， 在 具体 使 用 上 其 实 大 致 都 相同 。 接 下 来 以 MySQL 为 例 ， 具 体 介绍 如 何 操作 数据 库 。 


4.2 ”使 用 JDBC 操作 数据 库 


JDBC 的 全 名 是 Java DataBase Connectivity, 可 能 是 我 们 最 先 接触 到 的 数据 库 连 接 , 通过 JDBC 
可 以 直接 使 用 Java 编程 来 操作 数据 库 。 其 实 我 们 可 以 这 样 理 解 DBC， 它 就 是 一 个 可 以 执行 SQL 
语句 的 Java API。 

4.1 节 讲 了 很 多 数据 库 , 本 节 以 MySQL 为 例 介 绍 Spring Boot 使 用 JDBC 操作 MySQL 数据 库 。 
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4.2.1 JDBC 依赖 配置 


新 建 项 目 ， 在 pom 文件 中 加 入 JDBC 依赖 和 MySQL 依赖 以 及 Web 功能 的 依赖 ， 如 代码 清单 
4-17 所 示 。 


代码 清单 4-17 JDBC 项 目 依赖 人 


<!-- WEB 依赖 --> 

«dependency» 
XgroupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-web«/artifactId» 

</dependency> 

<l== jdbc==-> 

<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-jdbc</artifactId> 

</dependency> 

«I-- pysql==> 

<dependency> 
XgroupId»mysql«/groupId» 
X«artifactId»mysgl-connector-java«/artifactId» 
«scope»runtime«/scope» 


</dependency> 


4.22 配置 数据 库 信息 


在 配置 文件 中 配置 数据 库 信息 ， 与 4.1 节 介绍 的 一 样 ， 配 置 文件 内 容 如 代码 清单 4-18 所 示 。 


代码 清单 4-18 JDBC 项 目 配置 代码 


## 数 据 库 地 址 

spring.datasource.url-jdbc:mysql://localhost:3306/test?characterEncoding- 
utf8&useSSL-false 

## 数 据 库 用 户 名 

spring.datasource.username-root 

## 数 据 库 密码 

spring.datasource.password-root 

## 数 据 库 驱动 


spring.datasource.driver-class-name-com.mysql.jdbc.Driver 
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423 ”创建 实体 类 


创建 一 个 实体 类 ， 用 作 接 收 表 数 据 ， 这 里 省 略 set, get 方法 ， 代 码 如 代码 清单 4-19 所 示 。 


代码 清单 4-19 JDBC MA User 实体 类 代码 


public class User ( 

private int id; 

private String user name; 

private String user password; 

public User(int id, String user name, String user password) ( 
this.id = id; 
this.user name - user name; 
this.user password - user password; 

} 

public User() { 

$ 


4.2.4 使 用 Controller 进行 测试 


新 建 一 个 UserController， 由 于 这 个 类 只 是 用 来 测试 使 用 JDBC 操作 数据 库 ， 因 此 我 们 在 类 上 
加 入 @RestController 注解 ， 熟 悉 Spring 的 人 都 知道 ， 这 个 注解 其 实 相 当 于 @ResponseBody 和 
(à)Controller 两 个 注解 结合 起 来 使 用 。 并 且 在 UserController 内 注入 JdbcTemplate， 代 码 如 代码 清单 
4-20 所 示 。 


代码 清单 4-20 JDBC 项 目 配置 代码 


GRestController 

public class UserController ( 
GAutowired 
private JdbcTemplate jdbcTemplate; 


其 中 ，@Autowired 注解 是 Spring 用 于 自动 装配 类 的 注解 ， 功 能 和 @Resource 类 似 。 刚 刚 我 们 
注入 的 JdbcTemplate 就 是 Spring Boot 使 用 JDBC 操作 数据 库 的 核心 , 接 下 来 进一步 对 它 进 行 学 习 。 

对 于 操作 数据 库 来 说 ， 其 实 基本 上 就 是 创建 〈Create) 、 更 新 (Update) 、 读 取 (Retrieve) 和 
删除 CDelete) 操作 。 而 对 于 JdbcTemplate 操作 数据 库 的 CURD， 基 本 上 分 为 三 种 方法 : 
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1. execute 方法 


execute 方法 用 来 直接 执行 SQL 语句 ， 是 最 直接 的 操作 数据 库 的 方法 。 接 下 来 我 们 在 
UserController 内 写 一 个 建 表 方 法 createTable 来 使 用 它 ， 方 法 内 容 如 代码 清单 4-21 所 示 。 


代码 清单 4-21 JDBC MA execute 方法 代码 


GGetMapping ("createTable") 
public String createTable()( 
String sql = 
"CREATE TABLE “user” (Mn" + 
" "id^ int(11) NOT NULL AUTO INCREMENT, An" + 
" "user name” varchar(255) NOT NULL, An" + 
" "user password? varchar (255) DEFAULT NULL, Wn" + 
" PRIMARY KEY (,id^)Nn" + 
") ENGINE-InnoDB AUTO INCREMENT-8 DEFAULT CHARSET-latinl;"; 
jdbcTemplate.execute (sql); 
return "创建 User 表 成 功 "; 
) 


启动 项 目 ， 在 浏览 器 上 访问 http://localhost:8080/createTable， 显 示 如 下 。 然 后 查看 数据 库 ， 顺 
利 地 创建 了 User 表 。 这 里 是 以 创建 表 为 例 ， 其 实 也 可 以 直接 执行 CURD 操作 ， 就 不 一 一 举例 了 。 

创建 User 表 成 功 

2. update 方法 


update 方法 多 用 于 增 、 删 、 改 操作 ，update 方法 默认 返回 一 个 int 值 ， 了解 SQL 的 人 应 该 知道 ， 
方法 的 返回 值 就 是 影响 的 数据 行 数 ， 比 如 我 们 数据 库 中 存在 两 条 性 别 为 男 的 用 户 数据 ， 当 执行 
update 语句 修改 性 别 为 男 的 数据 时 , 执行 成 功 后 , 我 们 可 以 得 到 返回 值 2, 这 个 就 是 我 们 执行 update 
方法 的 返回 值 ， 新 增 、 删 除 操作 的 原理 类 似 。 当 然 ， 也 支持 直接 执行 SQL 语句 ， 比 如 下 面 的 方法 
saveUserSql， 直 接 执行 一 个 插入 语句 ， 代 码 如 代码 清单 4-22 所 示 。 


代码 清单 4-22 JDBC 项 目 update 方法 代码 


@GetMapping ("saveUserSql") 
public String saveUserSql()( 
String sql - "INSERT INTO USER (USER NAME,USER PASSWORD) VALUES 
('dalaoyang','123')"; 
int rows- jdbcTemplate.update (sql); 
return "执行 成 功 ， 影 响 "+rows+" 行 "; 
} 


重启 项 目 ， 在 浏览 器 访问 可 以 看 到 : 
执行 成 功 ， 影 响 1 行 
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上 面 的 场景 可 能 并 不 常用 ， 甚 至 基本 上 用 不 到 ， 因 为 插入 的 数据 不 可 能 是 已 知 的 并 且 都 是 固 
定 的 。 揪 入 的 数据 是 动态 的 怎么 办 呢 ? update 方法 中 也 是 支持 传 值 进去 的 ， 只 需要 在 执行 的 SQL 
上 用 问号 来 代替 参数 ， 其 中 update 方法 内 第 一 个 参数 是 执行 的 SQL， 接 着 对 应 传 入 动态 的 参数 即 
可 。 下 面 3 个 方法 分 别 列举 了 增 、 删 、 改 的 方法 ， 代 码 如 代码 清单 4-23 所 示 。 


代码 清单 4-23 JDBC 项 目 增加 、 删 除 、 修 改 方法 代码 


// 新 增 方法 
QGetMapping ("saveUser") 
public String saveUser(String userName,String passWord)( 


int rows- jdbcTemplate.update ("INSERT INTO USER (USER NAME,USER PASSWORD) 
VALUES (?,?)",userName,passWord); 


return "执行 成 功 ， 影 响 "+rows+" 行 "; 


// 修 改 方法 
GGetMapping ("updateUserPassword") 
public String updateUserPassword(int id,String passWord)(í( 
int rows- jdbcTemplate.update ("UPDATE USER SET USER PASSWORD = ? WHERE ID 
- ?",passWord,id); 
return "执行 成 功 ， 影 响 "+rows+" 行 "; 
} 


// 删 除 方法 

@GetMapping ("deleteUserById") 

public String deleteUserById(int id)( 
int rows- jdbcTemplate.update("DELETE FROM USER WHERE ID - ?",id); 
return "执行 成 功 ， 影 响 "+rows+" 行 "; 

} 


这 里 就 不 一 一 测试 了 ， 感 兴趣 的 读者 可 以 自行 测试 。 接 下 来 我 们 继续 学 习 update 方法 的 延伸 ， 
其 实 JdbcTemplate 中 也 提供 了 批 处 理 方法 batchUpdate, 可 以 传 入 SQL 和 一 个 批 处 理 的 数组 进行 操 
作 。 比 如 下 面 的 batchSaveUserSql 方法 ， 可 以 批量 插入 10 条 数据 ， 代 码 如 代码 清单 4-24 所 示 。 


代码 清单 4-24 JDBC 项 目 batchSaveSq| 方法 代码 


@GetMapping ("batchSaveUserSql") 
public String batchSaveUserSql()í 
String sql - 
"INSERT INTO USER (USER NAME,USER PASSWORD) VALUES (?,?)" ; 
List«Object[]» paramList = new ArrayList«»(); 
for (int i= OF i < 7105 144) f 
String[] arr = new String[2]; 
arr[0] = "zhangsan"+i; 
arr[1] = "password"+i; 
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paramList.add (arr); 
5 
jdbcTemplate.batchUpdate (sql,paramList); 
return "执行 成 功 "7 


3. query 方法 


query 方法 看 名 字 就 能 想到 ， 用 于 执行 有 关 查 询 的 方法 。 
首先 我 们 使 用 一 个 JdbcTemplate 的 query 方法 ， 这 里 可 以 用 到 之 前 创建 的 实体 类 User， 方 法 
如 下 ， 根 据 userName 查询 一 个 列表 ， 代 码 如 代码 清单 4-25 所 示 。 


代码 清单 4-25 JDBC 项目 query 方法 代码 


@GetMapping ("getUserByUserName") 
Public List getUserByUserName (String userName){ 
String sql = "SELECT * FROM USER WHERE USER NAME = ?"; 
List<User> list= jdbcTemplate.query(sql,new Object[] {userName},new 
BeanPropertyRowMapper<> (User.class)); 
return list; 


} 


EAMH, 在 浏览 器 上 访问 http://localhost:8080/getUserByUserName?userName=zhangsan0， 如 
下 所 示 : 


[{"id":10,"user name":"zhangsan0","user password":"password0"}] 


刚刚 我 们 使 用 了 一 个 返回 List 集合 的 方法 ， 接 下 来 使 用 一 个 返回 Map 的 方法 queryForMap， 
代码 如 代码 清单 4-26 所 示 。 


代码 清单 4-26 JDBC WA execute 方法 代码 


@GetMapping ("getMapById") 

public Map getMapById(Integer id){ 
String sql - "SELECT * FROM USER WHERE ID - ?"; 
Map map” jdbcTemplate.queryForMap (sql, id); 
return map; 


) 


在 浏览 器 访问 http:Wlocalhost:8080/getMapById?id=1， 如 下 所 示 : 
["id":1,"user name";"lisi","user password":"111"] 


接 下 来 我 们 查询 一 个 数据 库 中 不 存在 的 数据 ， 在 浏览 器 访问 http://localhost:8080/ 
getMapById?id=1000， 页 面 显示 如 图 4-14 所 示 。 
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eoe < D localhost [9 


Whitelabel Error Page 


This application has no explicit mapping for /error so you are seeing this as a fallback. 


Thu Aug 23 00:11:54 CST 2018 
There was an unexpected error (type=Internal Server Error, status-500). 
Incorrect result size: expected 1, actual 0 


4-14 JDBC MH Error 


我 们 回 过 头 看 一 下 控制 台 ， 报 错 如 代码 清单 4-27 所 示 。 


BC 项 目 控制 台 错 误 代码 


org.springframework.dao.EmptyResultDataAccessException: Incorrect result 

size: expected 1, actual 0 

at org.springframework.dao.support.DataAccessUtils. 
nullableSingleResult (DataAccessUtils.java:97) 
^[spring-tx-5.0.7.RELEASE.jar:5.0.7.RELEASE] 

at org.springframework.jdbc.core.JdbcTemplate.queryForObject 
(JdbcTemplate.java:772) -[spring-jdbc-5.0.7.RELEASE.jar:5.0.7.RELEASE] 

at org.springframework.jdbc.core.JdbcTemplate.queryForMap 
(JdbcTemplate.java:807) -[spring-jdbc-5.0.7.RELEASE.jar:5.0.7.RELEASE] 

at com.dalaoyang.controller.UserController.getMapById 
(UserController.java:104) -[classes/:na] 

at sun.reflect.NativeMethodAccessorImpl.invoke0 (Native Method) 
7[na:1.8.0 131] 

at sun.reflect.NativeMethodAccessorImpl.invoke 
(NativeMethodAccessorImpl.java:62) -[na:1.8.0 131] 

at sun.reflect.DelegatingMethodAccessorImpl.invoke 
(DelegatingMethodAccessorImpl.java:43) -[na:1.8.0 131] 

at java.lang.reflect.Method.invoke (Method.java:498) -[na:1.8.0 131] 

at org.springframework.web.method.support.InvocableHandlerMethod. 
doInvoke (InvocableHandlerMethod.java:209) 
^[spring-web-5.0.7.RELEASE.jar:5.0.7.RELEASE] 

at org.springframework.web.method.support.InvocableHandlerMethod. 
invokeForRequest (InvocableHandlerMethod.java:136) 
^[spring-web-5.0.7.RELEASE.jar:5.0.7.RELEASE] 

at 
org.springframework.web.servlet.mvc.method.annotation.ServletInvocableHandle 
rMethod.invokeAndHandle (ServletInvocableHandlerMethod.java:102) 
^[spring-webmvc-5.0.7.RELEASE.jar:5.0.7.RELEASE] 

at org.springframework.web.servlet.mvc.method.annotation. 
RequestMappingHandlerAdapter.invokeHandlerMethod (RequestMappingHandlerAdapte 
r.java:877) -[spring-webmvc-5.0.7.RELEASE.jar:5.0.7.RELEASE] 
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at org.springframework.web.servlet.mvc.method.annotation. 
RequestMappingHandlerAdapter.handleInternal (RequestMappingHandlerAdapter.jav 
a:783) -[spring-webmvc-5.0.7.RELEASE.jar:5.0.7.RELEASE] 

at org.springframework.web.servlet.mvc.method. 
AbstractHandlerMethodAdapter.handle (AbstractHandlerMethodAdapter.java:87) 
^[spring-webmvc-5.0.7.RELEASE.jar:5.0.7.RELEASE] 

at org.springframework.web.servlet.DispatcherServlet.doDispatch 
(DispatcherServlet.java:991) -[spring-webmvc-5.0.7.RELEASE.jar:5.0.7.RELEASE] 

at org.springframework.web.servlet.DispatcherServlet.doService 
(DispatcherServlet.java:925) -[spring-webmvc-5.0.7.RELEASE.jar:5.0.7.RELEASE] 

at org.springframework.web.servlet.FrameworkServlet.processRequest 
(FrameworkServlet.java:974) -[spring-webmvc-5.0.7.RELEASE.jar:5.0.7.RELEASE] 

at org.springframework.web.servlet.FrameworkServlet.doGet 
(FrameworkServlet.java:866) -[spring-webmvc-5.0.7.RELEASE.jar:5.0.7.RELEASE] 

at javax.servlet.http.HttpServlet.service (HttpServlet.java:635) 
^[tomcat-embed-core-8.5.31.jar:8.5.31] 

at org.springframework.web.servlet.FrameworkServlet.service 
(FrameworkServlet.java:851) -[spring-webmvc-5.0.7.RELEASE.jar:5.0.7.RELEASE] 

at javax.servlet.http.HttpServlet.service (HttpServlet.java:742) 
^[tomcat-embed-core-8.5.31.jar:8.5.31] 

at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter 
(ApplicationFilterChain.java:231) -[tomcat-embed-core-8.5.31.jar:8.5.31] 

at org.apache.catalina.core.ApplicationFilterChain.doFilter 
(ApplicationFilterChain.java:166) -[tomcat-embed-core-8.5.31.jar:8.5.31] 

at org.apache.tomcat.websocket.server.WsFilter.doFilter 
(WsFilter.java:52) -[tomcat-embed-websocket-8.5.31.jar:8.5.31] 

at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter 
(ApplicationFilterChain.java:193) -[tomcat-embed-core-8.5.31.jar:8.5.31] 

at org.apache.catalina.core.ApplicationFilterChain.doFilter 
(ApplicationFilterChain.java:166) -[tomcat-embed-core-8.5.31.jar:8.5.31] 

at org.springframework.web.filter.RequestContextFilter. 
doFilterInternal(RequestContextFilter.java:99) 
^[spring-web-5.0.7.RELEASE.jar:5.0.7.RELEASE] 

at org.springframework.web.filter.OncePerRequestFilter.doFilter 
(OncePerRequestFilter.java:107) -[spring-web-5.0.7.RELEASE.jar:5.0.7.RELEASE] 

at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter 
(ApplicationFilterChain.java:193) -[tomcat-embed-core-8.5.31.jar:8.5.31] 

at org.apache.catalina.core.ApplicationFilterChain.doFilter 
(ApplicationFilterChain.java:166) -[tomcat-embed-core-8.5.31.jar:8.5.31] 

at org.springframework.web.filter.HttpPutFormContentFilter. 
doFilterInternal (HttpPutFormContentFilter.java:109) 
^[spring-web-5.0.7.RELEASE.jar:5.0.7.RELEASE] 
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at org.springframework.web.filter.OncePerRequestFilter.doFilter 
(OncePerRequestFilter.java:107) -[spring-web-5.0.7.RELEASE.jar:5.0.7.RELEASE] 

at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter 
(ApplicationFilterChain.java:193) -[tomcat-embed-core-8.5.31.jar:8.5.31] 

at org.apache.catalina.core.ApplicationFilterChain.doFilter 
(ApplicationFilterChain.java:166) -[tomcat-embed-core-8.5.31.jar:8.5.31] 

at org.springframework.web.filter.HiddenHttpMethodFilter. 
doFilterInternal(HiddenHttpMethodFilter.java:93) 
^[spring-web-5.0.7.RELEASE.jar:5.0.7.RELEASE] 

at org.springframework.web.filter.OncePerRequestFilter.doFilter 
(OncePerRequestFilter.java:107) -[spring-web-5.0.7.RELEASE.jar:5.0.7.RELEASE] 

at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter 
(ApplicationFilterChain.java:193) -[tomcat-embed-core-8.5.31.jar:8.5.31] 

at org.apache.catalina.core.ApplicationFilterChain.doFilter 
(ApplicationFilterChain.java:166) -[tomcat-embed-core-8.5.31.jar:8.5.31] 

at org.springframework.web.filter.CharacterEncodingFilter. 
doFilterInternal(CharacterEncodingFilter.java:200) 
^[spring-web-5.0.7.RELEASE.jar:5.0.7.RELEASE] 

at org.springframework.web.filter.OncePerRequestFilter.doFilter 
(OncePerRequestFilter.java:107) -[spring-web-5.0.7.RELEASE.jar:5.0.7.RELEASE] 

at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter 
(ApplicationFilterChain.java:193) -[tomcat-embed-core-8.5.31.jar:8.5.31] 

at org.apache.catalina.core.ApplicationFilterChain.doFilter 
(ApplicationFilterChain.java:166) -[tomcat-embed-core-8.5.31.jar:8.5.31] 

at org.apache.catalina.core.StandardWrapperValve.invoke 
(StandardWrapperValve.java:198) -[tomcat-embed-core-8.5.31.jar:8.5.31] 

at org.apache.catalina.core.StandardContextValve.invoke 
(StandardContextValve.java:96) [tomcat-embed-core-8.5.31.jar:8.5.31] 

at org.apache.catalina.authenticator.AuthenticatorBase.invoke 
(AuthenticatorBase.java:496) [tomcat-embed-core-8.5.31.jar:8.5.31] 

at org.apache.catalina.core.StandardHostValve.invoke 
(StandardHostValve.java:140) [tomcat-embed-core-8.5.31.jar:8.5.31] 

at org.apache.catalina.valves.ErrorReportValve.invoke 
(ErrorReportValve.java:81) [tomcat-embed-core-8.5.31.jar:8.5.31] 

at org.apache.catalina.core.StandardEngineValve.invoke 
(StandardEngineValve.java:87) [tomcat-embed-core-8.5.31.jar:8.5.31] 

at org.apache.catalina.connector.CoyoteAdapter.service 
(CoyoteAdapter.java:342) [tomcat-embed-core-8.5.31.jar:8.5.31] 

at org.apache.coyote.httpll.HttpllProcessor.service 
(HttpllProcessor.java:803) [tomcat-embed-core-8.5.31.jar:8.5.31] 

at org.apache.coyote.AbstractProcessorLight.process 


(AbstractProcessorLight.java:66) [tomcat-embed-core-8.5.31.jar:8.5.31] 
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at org.apache.coyote.AbstractProtocol$ConnectionHandler.process 
(AbstractProtocol.java:790) [tomcat-embed-core-8.5.31.jar:8.5.31] 

at org.apache.tomcat.util.net.NioEndpoint$SocketProcessor.doRun 
(NioEndpoint.java:1468) [tomcat-embed-core-8.5.31.jar:8.5.31] 

at org.apache .tomcat .util.net.SocketProcessorBase.run 
(SocketProcessorBase.java:49) [tomcat-embed-core-8.5.31.jar:8.5.31] 

at java.util.concurrent.ThreadPoolExecutor.runWorker 
(ThreadPoolExecutor.java:1142) [na:1.8.0 131] 

at java.util.concurrent.ThreadPoolExecutor$Worker.run 
(ThreadPoolExecutor.java:617) [na:1.8.0 131] 

at org.apache.tomcat.util.threads.TaskThread$WrappingRunnable.run 
(TaskThread.java:61) [tomcat-embed-core-8.5.31.jar:8.5.31] 

at java.lang.Thread.run(Thread.java:748) [na:1.8.0 131] 


接 下 来 查看 一 下 DataAccessUtils 源 代码 ， 可 以 看 到 nullableSingleResult 在 查 到 空 集合 的 时 候 
默认 抛 出 EmptyResultDataAccessException 异常 ， 看 到 就 明白 了 。 我 们 修改 一 下 getMapByld 方法 ， 


在 方法 内 捕获 EmptyResultDataAccessException 异常 ， 方 法 代码 修改 如 代码 清单 4-28 所 示 。 


代码 清单 4-28 JDBC 项 目 getMapByld 方法 人 


@GetMapping ("getMapById") 
public Map getMapById(Integer id){ 
String sql - "SELECT * FROM USER WHERE ID - ?"; 
Map map - null; 
tryí 
map- jdbcTemplate.queryForMap (sql, id); 
)catch (EmptyResultDataAccessException e)( 
return null; 
$ 


return map; 


} 


前 面 介绍 了 返回 List 集合 .Map 集合 , 接 下 来 学 习 一 个 返回 User 实体 类 的 方法 queryForObject。 
基于 刚刚 查 不 到 结果 抛 出 异常 的 原因 , E — SEEK ES 在 这 个 方法 中 直接 捕获 这 个 异常 ， 方 法 如 代 


码 清单 4-29 所 示 。 


代码 清单 4-29 JDBC MA getUserByld 方法 代码 


@GetMapping ("getUserById") 
public User getUserById(Integer id)( 
String sql = "SELECT * FROM USER WHERE ID = ?"; 
User user- null; 
tryt{ 
user = jdbcTemplate.queryForObject (sql,new Object[] {id},new 
BeanPropertyRowMapper<> (User.class)); 


ge ——————————— 


}catch (EmptyResultDataAccessException e){ 
return null; 

b 

return user; 


) 


测试 就 不 再 袭 述 了 ， 和 之 前 的 方法 一 样 。 到 这 里 ，Spring Boot 使 用 JDBC 就 告 一 段落 了 ， 毕 
竞 在 实际 开发 中 对 JDBC 的 使 用 不 是 很 多 ， 有 一 定 基础 就 可 以 了 。 


4.8 使 用 JPA 操作 数据 库 


4.3.1 JPA 介绍 


JPA 是 Java Persistence API 的 简称 ， 是 JCP 组 织 发 布 的 Java EE 标准 之 一 。JPA 是 一 种 面向 对 
象 的 查询 语言 ， 定 义 了 独特 的 JPQL (Java Persistence Query Language) ， 是 一 种 针对 实体 的 查询 语 
言 ， 无 论 是 查询 还 是 修改 ， 全 部 操作 的 都 是 对 象 实体 ， 而 非 数据 库 的 表 。 


4.3.2 JPA 依赖 配置 


新 建 项 目 ， 在 pom 文件 中 加 入 JPA 依赖 、MySQL 依赖 以 及 Web 功能 依赖 ， 如 代码 清单 4-30 


代码 清单 4-30 JPA 项 目 依赖 代码 


<!-- JPA 依赖 --> 

«dependency» 
XgroupId»org.springframework.boot«/groupId» 
XartifactId»spring-boot-starter-data-jpa«/artifactId» 

«/dependency» 

<!-- WEB 依赖 --> 

<dependency> 
XgroupId»org.springframework.boot«/groupId» 
X«artifactld»spring-boot-starter-web«/artifactId» 

</dependency> 

<!-- Mysql 依赖 --> 

<dependency> 
XgroupId»mysql«/groupId» 
X«artifactId»mysql-connector-java«/artifactId» 
Xscope»runtime«c/scope» 

</dependency> 
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4.3.3 配置 文件 


在 配置 文件 中 加 入 数据 库 配 置 ， 与 4.1 节 介 绍 的 一 致 。 接 下 来 进行 JPA 的 基本 配置 ， 比 如 
spring.jpa.hibernate.ddl-auto。 其 提供 了 如 下 几 种 配置 。 


* validate: 在 加 载 hibernate 时 ， 验 证 创建 数据 库 表 结 构 。 

* create: 每 次 加 载 hibernate， 重 新 创建 数据 库 表 结构 ， 设 置 时 要 注意 ， 如 果 设 置 错误 的 话 ， 就 
会 造成 数据 的 丢失 。 

* create-drop: 在 加 载 的 时 候 创建 表 ， 在 关闭 项 目 时 删除 表 结 构 。 

* update: 加 载 时 更 新 表 结构 。 

* none: 加 载 时 不 做 任何 操作 。 


根据 具体 情况 选择 配置 即 可 。 另 外 ， 如 果 需 要 ， 我 们 也 可 以 加 入 spring.jpa.show-sql 配置 ， 设 
置 为 true 时 ， 可 以 在 控制 台 打 印 SQL. 
案例 配置 代码 如 代码 清单 4-31 所 示 。 


代码 清单 4-31 JPA 项 目 配置 文件 代码 


## 数 据 库 配 置 

## 数 据 库 地 址 

spring.datasource.url-jdbc:mysql://localhost:3306/test?characterEncoding- 
utf8&useSSL-false 

## 数 据 库 用 户 名 

spring.datasource.username-root 

## 数 据 库 密码 

spring.datasource.password-root 

## 数 据 库 驱动 


spring.datasource.driver-class-name-com.mysql.jdbc.Driver 


# JPA 配置 

##validate 加 载 hibernate 时 ， 验 证 创建 数据 库 表 结 构 

##create 每 次 加 载 hibernate， 重 新 创建 数据 库 表 结构 ， 这 就 是 导致 数据 库 表 数 据 丢 失 的 原因 
##create-drop 加 载 hibernate 时 创建 ， 退 出 时 删除 表 结 构 

##update 加 载 hibernate 自动 更 新 数据 库 结构 

##none 启动 时 不 做 任何 操作 

spring.jpa.hibernate.ddl-auto-create 

## 控 制 台 打印 SQL 


spring.jpa.show-sql=true 


4.3.4 创建 实体 对 象 


创建 一 个 实体 对 象 ， 在 类 上 加 入 注解 @Entity 来 表明 这 是 一 个 实体 类 , 在 属性 上 使 用 @Id 表明 
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这 是 数据 库 中 的 主键 ID， 使 用 @GeneratedValue(strategy = GenerationType.IDENTITY) 表 明 此 字段 
自 增 长 ， 在 属性 上 加 入 @Column(nullable = falseunique = true) 可 以 设置 字段 的 一 些 属性 ， 比 如 
nullable 为 非 空 、unique 唯一 约束 ， 还 提供 了 其 他 属性 ， 这 里 就 不 一 一 介绍 了 。User 实体 类 代码 如 
代码 清单 4-32 所 示 。 


代码 清单 4-32 JPA 项 目 User 实体 类 代 


GEntity 
public class User( 


Gerd 
GGeneratedValue (strategy = GenerationType.IDENTITY 


private Long id; 

@Column (nullable = false,unique = true) 
private String userName; 

GColumn 

private String userPassword; 


public Long getId() ( 
return id; 


5 


public void setId(Long id) ( 
this.id = id; 
F 


public String getUserName() ( 
return userName; 


$ 


public void setUserName (String userName) { 
this.userName = userName; 
i; 


public String getUserPassword() ( 
return userPassword; 


) 


public void setUserPassword(String userPassword) ( 
this.userPassword - userPassword; 
b 


public User(Long id,String userName, String userPassword) ( 
this.id - id; 
this.userName - userName; 
this.userPassword - userPassword; 
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public User(String userName, String userPassword) ( 
this.userName - userName; 
this.userPassword = userPassword; 

ji 


public User() ( 
) 


4.3.5 创建 数据 操作 层 


新 建 一 个 repository 接口 ， 使 其 继承 JpaRepository， 这 个 接口 默认 提供 一 组 与 JPA 规范 相关 的 
方法 ， 其 源 代码 如 代码 清单 4-33 所 示 。 


代码 清单 4-33 JPA 项 目 JpaReposito 


GNoRepositoryBean 
public interface JpaRepository«T, ID» extends PagingAndSortingRepository«T, 
ID», QueryByExampleExecutor«T» ( 
List«T» findAll(); 


List«T» findAll(Sort varl); 

List«T» findAllById(Iterable«ID^ varl); 

<S extends T» List«S» saveAll(Iterable«S» varl); 
void flush(); 

<S extends T» S saveAndFlush(S varl); 

void deleteInBatch(Iterable«T» varl); 

void deleteAllInBatch(); 

T getOne(ID varl); 

XS extends T> List«S» findAll(Example«S» varl); 


<S extends T> List«S» findAll(Example«S» varl, Sort var2); 


) 


从 源 代码 中 可 以 看 到 ， 默 认为 我 们 提供 了 很 多 简单 的 方法 ， 如 findAIl). getOneQ ^, m 
JpaRepository 则 继承 了 PagingAndSortingRepository 接口 。PagingAndSortingRepository 接口 代码 如 
代码 清单 4-34 所 示 。 


代码 清单 4-34 JPA 项 目 PagingAndSortingRepository 类 代码 


GNoRepositoryBean 
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public interface PagingAndSortingRepository<T, ID> extends CrudRepository«T, 
ID» ( 
Iterable«T» findAll(Sort varl); 


Page<T> findAll(Pageable varl); 
) 


PagingAndSortingRepository 接口 继承 了 CrudRepository 接口 ， 实 现 了 有 关 分 页 排序 等 相关 的 
方法 ， 其 代码 如 代码 清单 4-35 所 示 。 


代码 清单 4-35 JPA 项 目 CrudRepository 类 代码 


GNoRepositoryBean 
public interface CrudRepository«T, ID» extends Repository«T, ID» ( 
XS extends T» S save(S varl); 


<S extends T» Iterable«S» saveAll(Iterable«S» varl); 
Optional«T» findById(ID varl); 

boolean existsById(ID varl); 

Iterable«T» findAll(); 

Iterable«T» findAllById(Iterable«XID» varl); 

long count(); 

void deleteById(ID varl); 

void delete(T varl); 

void deleteAll(Iterable«? extends T> varl); 


void deleteAl1(); 
J 


CrudRepository 接口 继承 了 Spring Data JPA 的 核心 接口 Repository, 实现 了 有 关 CRUD 相关 的 
方法 〈 增 、 删 、 改 、 查 ) 。 在 Repository 接口 中 没有 提供 任何 方法 ， 仅 仅 作为 一 个 标识 来 让 其 他 类 
实现 它 作为 仓库 接口 类 ， 其 代码 如 代码 清单 4-36 所 示 。 


代码 清单 4-36 JPA 项 目 Repository 类 代码 


@Indexed 
public interface Repository<T, ID» ( 
H 


细心 的 读者 可 以 看 到 ， 除 了 Repository 接口 以 外 ， 其余 接 口 都 含有 一 个 @NoRepositoryBean it 
解 ， 加 入 这 个 注解 的 类 ，Spring 就 不 会 实例 化 ， 用 作 父 类 的 Repository。 
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4.3.6 简单 测试 运行 


新 建 一 个 Controller 进行 测试 ， 创 建 一 个 UserController， 在 控制 层 注 入 刚刚 创建 的 
UserRepository， 并 在 控制 层 创建 CURD 的 4 个 方法 ， 代 码 如 代码 清单 4-37 所 示 。 


GRestController 
GRequestMapping ("test") 
public class UserController ( 


GAutowired 
private UserRepository userRepository; 


/ /http://localhost:8080/test/saveUser?userName- 
$E5$A4$A7$E8$80$81$E6*$9D$A8&userPassword-123 
@GetMapping (value = "/saveUser") 
public void saveUser (String userName, String userPassword) ( 
User user = new User (userName, userPassword); 
userRepository.save (user); 


) 


/ /http://localhost:8080/updateUser?Id-l&userName- 
$E5$A4$A7$E8$80$81$9E6$9D$A8&userPassword-1111 
GGetMapping(value = "/updateUser") 
public void updateUser(Long Id,String userName,String userPassword)( 
User user - new User(Id,userName, userPassword); 
userRepository.save (user); 
li 


//http://localhost:8080/deleteUser?Id=1 

@GetMapping (value = "/deleteUser") 

public void deleteUser (Long Id) ( 
userRepository.deleteById(Id); 

p 


/ /http://localhost:8080/getUserById?Id-1 

@GetMapping (value = "/getUserById") 

public Optional<User> getUserById(Long Id) { 
return userRepository.findById(Id); 


) 


从 上 面 的 代码 可 以 看 到 ， 在 使 用 JPA 操作 数据 库 时 ， 操 作 特别 简单 ， 基 本 上 使 用 Repository 
提供 的 几 个 方法 已 经 可 以 满足 我 们 的 需求 。 
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4.3.7 JPA 扩展 学 习 


前 面 学 习 了 JPA 的 简单 使 用 ， 接 下 来 我 们 对 它 进行 扩展 学 习 。 在 JPA 使 用 中 ， 可 以 通过 一 些 
特定 的 命名 规则 实现 对 SQL 语句 条 件 的 改变 。 

假设 有 一 个 User 表 , 内 含 字段 id(int)、user_name(varchar[50])、pass_word(varchar[50])、age(int)、 
birthday(date)、is_enable(tinyint[1])。 表 4-1 显示 了 通过 特定 命名 规则 对 SQL 语句 的 改变 。 


表 4-1 通过 特定 命名 规则 对 表 User 进行 的 SQL 语言 的 运用 
序 号 | 关键 字 x 例 范例 SQL 
SELECT* FROM User WHERE user name 
1 And findByUserNameAndPassword 一 
=?1AND pass word = ?2 
SELECT * FROM User WHERE user name 
2 Or findByUserNameOrPassword za 
=?1 OR pass word - ?2 
SELECT * FROM User WHERE user name 
3 Is findByUserNamels -" = 
SELECT * FROM User WHERE user_name 
4 Equals findByUserNameEquals -" uu 
: SELECT * FROM User WHERE birthday 
5 Between findByBirthday Between 
BETWEEN ?1 AND ?2 
6 LessThan findByAgeLessThan SELECT * FROM User WHERE age < ?1 
7 LessThanEqual findByA geLessThanEqual SELECT * FROM User WHERE age <= ?1 
8 GreaterThan findByA geGreaterThan SELECT * FROM User WHERE age > ?1 
9 GreaterThanEqual | findByAgeGreaterThanEqual SELECT * FROM User WHERE age >= ?1 
" SELECT * FROM User WHERE birthday 
10 After findByBirthdayA fter > 
, SELECT * FROM User WHERE birthday 
1 Before findByBirthdayBefor e? 
SELECT * FROM User WHERE pass word 
12 IsNull findByPasswordIsNull a 
IS NULL 
SELECT * FROM User WHERE pass_word 
13 IsNotNull findByPasswordIsNotNull 
IS NOT NULL 
SELECT * FROM User WHERE pass_word 
14 NotNull findByPasswordNotNull 
IS NOT NULL 
: . SELECT * FROM User WHERE user name 
15 Like findByUserNameLike 
LIKE ?1 
x : SELECT * FROM User WHERE user name 
16 NotLike findByUserNameNotLike B 
NOTLIKE ?1 
SELECT * FROM User WHERE user name 
17 StartingWith findByUserNameStartingWith LIKE ?1 (parameter bound with appended 
Yo) 


第 4 章 Spring Boot 的 数据 库 之 旅 | 75 


CER) 

FSIE + a 范例 SQL 
SELECT* FROM User WHERE user name 
18 EndingWith findByUserNameEndingWith LIKE ?1 (parameter bound with prepended 


Yo) 
SELECT* FROM User WHERE user name 


19 Containing findByUserNameContaining Ki 
LIKE ?1 (parameter bound wrappedin Yo) 
SELECT* FROM User WHERE user name 
20 OrderBy findByUserNameOrderByAgeAsc É 
=?1 ORDER BY age ASC 
SELECT * FROM User WHERE user name 
21 Not findByUserNameNot E 
> 
findByUserNameln(Collection 
22 In SELECT* FROM User WHERE age IN ?1 
<Age> age) 
n Nds findByUserNameNotIn(Collection | SELECT * FROM User WHERE age NOT 
«Age» age) IN?I 
SELECT * FROM User WHERE userName 
24 True findBylIsenableTrue 
—?1 AND passWord = ?2 
23 Notin findByUserNameNotIn(Collection | SELECT * FROM User WHERE age NOT 
H «Age» age) IN?I 
SELECT * FROM User WHERE userName 
24 True findBylIsenableTrue 


=?1 AND passWord = ?2 


上 述 方法 都 是 基于 既定 的 接 品 规则， 其实 JPA 是 支持 注解 形式 执行 SQL 语句 操作 的 ， 比 如 在 
接口 上 使 用 @Query， 在 内 容 中 放 入 需要 执行 的 SQL 语句 ， 如 代码 清单 4-38 所 示 。 


代码 清单 4-38 JPA 项 目 findAllByUserName 方法 代码 


@Query ("SELECT u FROM User u WHERE user name = :userName") 
User findAllByUserName (@Param ("userName") String userName); 


需要 注意 的 是 ， 这 里 是 以 对 象 为 单位 查询 的 ， 比 如 上 面 使 用 的 是 查询 的 SELECT u， 而 不 是 我 
们 在 SQL 内 写 的 SELECT *， 使 用 @Param 给 参数 取 别 名 ， 方 便 在 SQL 内 使 用 。JPA 的 使 用 就 扩 
展 到 这 里 ， 其 用 法 还 有 很 多 ， 感 兴趣 的 读者 可 以 参考 官方 文档 : https://docs.spring.io/spring-data/ 
data-jpa/docs/current/api/。 


4.3.8 基于 WebFlux 的 使 用 


之 前 我 们 提 到 过 Spring Boot 2.X 版 本 新 提供 的 WebFlux， 接 下 来 改 用 WebFlux 操作 JPA. 
WebFlux 暂时 还 不 支持 关系 型 数据 库 ， 所 以 本 小 节 的 数据 库 改 用 MongoDB， 介 绍 响应 式 编程 操作 
数据 库 。 


1. 更 换 为 WebFlux 依赖 


新 建 一 个 项 目 ， 在 pom 文件 中 加 入 spring-boot-starter-data-mongodb-reactive 和 spring-boot- 
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starter-webflux 依赖 。 完 整 pom 文件 依赖 代码 内 容 如 代码 清单 4-39 所 示 。 
代码 清单 4-39 JPA 项 目 基于 WebFlux 依赖 的 代码 


<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-data-mongodb-reactive</artifactId> 

</dependency> 

<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-webflux</artifactId> 

</dependency> 

<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-devtools</artifactId> 
<scope>runtime</scope> 

</dependency> 

<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-test</artifactId> 
<scope>test</scope> 

</dependency> 


在 配置 文件 中 配置 MongoDB 数据 库 信息 ， 配 置 内 容 如 代码 清单 4-40 所 示 。 


代码 清单 4-40 JPA 项 目 基于 WebFlux 配置 文件 代码 


##mongo 配置 
spring.data.mongodb.host-127.0.0.1 
spring.data.mongodb.port-27017 
spring.data.mongodb.database-test 


创建 一 个 实体 类 ， 实 体 类 内 容 如 代码 清单 4-41 所 示 。 


Public class UserInfo { 
@Id 
Private Long id; 
Private String username; 
Private String password; 


// 省 略 set、get 方法 


代码 清单 4-41 JPA 项 目 基 于 WebFlux 依赖 Userlnfo 类 代码 
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创建 数据 操作 层 UserRepository, 在 使 用 WebFlux 时 , 我 们 需要 继承 ReactiveMongoRepository， 
类 代码 内 容 如 代码 清单 4-42 所 示 。 


代码 清单 4-42 JPA 项 目 基于 WebFlux 依赖 UserRepository 类 代码 


Public interface UserRepository extends 
ReactiveMongoRepository«UserInfo,Long» { 


) 


在 第 3 章 我 们 学 习 WebFlux 响应 式 编程 的 时 候 了 解 到 ， 需 要 创建 一 个 Handler 用 于 实现 具体 
方法 ， 再 创建 一 个 Router 用 于 路 由 跳 转 。 首 先 ， 创 建 一 个 UserHandler， 我 们 先 写 一 个 保存 用 户 的 
方法 ， 在 WebFlux 中 可 以 利用 下 面 的 方法 直接 获取 Post 请 求 对 象 体 (Requestbody) 中 的 对 象 ， 如 
代码 清单 4-43 所 示 。 


代码 清单 4-43 JPA 项 目 基 于 WebFlux 依赖 bodyToMono 的 使 用 代码 


Mono<UserInfo> user = request.bodyToMono (UserInfo.class); 


其 中 ，request 是 ServerRequest 对 象 ， 通 过 上 面 的 方法 可 以 直接 将 Post. 请 求 中 的 方法 体 
(Requestbody) 数据 转换 为 UserInfo 对 象 。 我 们 来 完善 一 下 保存 方法 ， 方 法 内 容 如 代码 清单 4-44 
所 示 。 


代码 清单 4-44 JPA 项 目 基 于 WebFlux 依赖 saveUser 方法 的 代码 


public Mono<ServerResponse> saveUser(ServerRequest request) ( 
Mono«UserInfo» user = request.bodyToMono (UserInfo.class); 
return ServerResponse.ok().build(repository.insert (user).then()); 
} 


在 方法 返回 值 中 使 用 ServerResponse.ok() 方 法 表明 返回 状态 成 功 ， 在 类 似 插入 、 修 改 等 不 需要 
返回 值 的 方法 后 面 加 入 then() 方 法 返回 一 个 Mono<Void>。 

修改 方法 与 插入 方法 类 似 ， 这 里 不 再 歼 述 。 接 下 来 我 们 来 看 一 个 查询 方法 ， 比 如 想 获取 ID 为 
1 的 用 户 ， 就 可 以 利用 requestpathVariable 方法 获取 路 径 中 的 参数 ， 如 代码 清单 4-45 所 示 。 


代码 清单 4-45 JPA 项 目 基于 WebFlux 依赖 获取 链接 参数 代码 


Long userId = Long.valueOf (request.pathVariable("id")); 


我 们 可 以 清楚 地 看 到 ， 上 述 代 码 就 是 从 路 径 中 获取 id 的 Long 值 。 完 善 一 下 方法 , 将 查询 到 的 
用 户 返回 ， 方 法 内 容 如 代码 清单 4-46 所 示 。 


代码 清单 4-46 JPA 项 目 基于 WebFlux 依赖 getUser 方法 代码 


public Mono<ServerResponse> getUser(ServerRequest request) { 
Long userId = Long.valueOf (request.pathVariable ("id")); 


78 | Spring Boot 2 实战 之 旅 


Mono<UserInfo> userInfo = repository.findById(userId); 
return ServerResponse.ok().contentType (APPLICATION JSON). 
body(userInfo, UserInfo.class); 
H 


与 插入 方法 不 同 的 是 , 在 返回 值 上 表明 了 contentType， 这 里 设置 成 了 application/json， 并 且 利 
用 body 方法 将 查询 内 容 返 回 。 

这 里 还 列举 了 删除 方法 和 查询 列表 方法 的 内 容 ， 和 前 面 介绍 的 方法 类 似 ， 可 以 参考 使 用 。 
UserHandler 类 如 代码 清单 4-47 所 示 。 


青 单 4-47 JPA 项 目 基于 WebFlux 依赖 UserHandler 


GComponent 
public class UserHandler { 


private final UserRepository repository; 


public UserHandler(UserRepository repository) ( 
this.repository - repository; 


/ /http://localhost:8080/saveUser 

public MonoXServerResponse» saveUser(ServerRequest request) { 
Mono«UserInfo» user = request.bodyToMono(UserInfo.class); 
return ServerResponse.ok().build(repository.insert (user).then()); 


/ /http://1localhost:8080/deleteUser/1 
public MonoXServerResponse» deleteUser(ServerRequest request) ( 
Long userId = Long.valueOf (request.pathVariable ("id")); 
return ServerResponse.ok().build(repository.deleteById(userId). 
then()); 
b 


/ /http://1localhost:8080/user/1 
public Mono«ServerResponse» getUser(ServerRequest request) ( 
Long userId = Long.valueOf (request.pathVariable ("id")); 
Mono«UserInfo» userInfo = repository.findById (userId); 
return ServerResponse.ok().contentType (APPLICATION JSON). 
body(userInfo, UserInfo.class); 
li 


//http://localhost:8080/listUser 
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public Mono<ServerResponse> listUser(ServerRequest request) ( 
Flux«UserInfo» userList = repository.findAll(); 
return ServerResponse.ok().contentType (APPLICATION JSON). 
body(userList, UserInfo.class); 


) 


创建 一 个 UserRouter 作为 路 由 , 在 其 中 配置 UserHandler 类 内 方法 对 应 路 由 ,如 代码 清单 4-48 
所 示 。 


GConfiguration 
public class UserRouter ( 


GBean 
public RouterFunction«ServerResponse» routeUser (UserHandler 
userHandler) ( 
return RouterFunctions 
.route (RequestPredicates.GET ("/listUser") 
.and (RequestPredicates.accept (MediaType. 
APPLICATION JSON)), 
userHandler::listUser) 
.andRoute (RequestPredicates.GET ("/user/(id)") 
.and (RequestPredicates.accept (MediaType. 
APPLICATION JSON)), 
userHandler::getUser) 
.andRoute (RequestPredicates.GET ("/deleteUser/(id)") 
.and (RequestPredicates.accept (MediaType. 
APPLICATION JSON)), 
userHandler::deleteUser) 
.andRoute (RequestPredicates.POST ("/saveUser") 
.and (RequestPredicates.accept (MediaType. 
APPLICATION JSON)), 
userHandler::saveUser); 


关于 测试 这 里 就 不 继续 介绍 了 ， 以 上 方法 都 是 笔者 亲 测 可 用 的 ， 感 兴趣 的 读者 可 以 自行 测试 。 
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44 使 用 MyBatis 操作 数据 库 


4.4.1 MyBatis 简介 


在 MyBatis 官网 (官网 地 址 : http:/www.mybatis.org/mybatis-3/zh/index.html) 上 是 这 样 介绍 
MyBatis 的 : MyBatis 是 一 款 优秀 的 持久 层 框架 ， 它 支持 定制 化 SQL、 存 储 过 程 以 及 高 级 映射 。 
MyBatis 避免 了 几乎 所 有 的 JDBC 代码 和 手动 设置 参数 以 及 获取 结果 集 。MyBatis 可 以 使 用 简单 的 
XML 或 注解 来 配置 和 映射 原生 信息 ， 将 接口 和 Java 的 POJOs (Plain Old Java Objects， 普 通 的 Java 
对 象 ) 映射 成 数据 库 中 的 记录 。 
通俗 地 理解 ，MyBatis 最 大 的 优点 是 : 
e ”可 以 手写 SQL， 比 较 灵 活 ， 对 于 很 多 互联 网 公司 、 业 务 和 友人 代 速 度 快 的 公司 或 者 业务 复杂 的 项 
目 ，MyBatis 修改 、 维 护 等 方面 更 加 灵活 。 

”从 学 习 成 本 上 来 说 ，MyBatis 上 手 更 加 容易 ， 基 本 上 没有 更 多 学 习 成 本 ， 这 是 很 多 公司 选用 
MyBatis 的 理由 。 

e 从 SQL 优化 方面 来 说 ， 手 写 的 SQL 优化 起 来 更 加 方便 。 


44.2 MyBatis 依赖 配置 


创建 项 目 , 在 pom 文件 中 加 入 MyBatis 依赖 和 MySQL 数据 库 依赖 , 代码 如 代码 清单 4-49 所 示 。 


代码 清单 4-49 MyBatis 项 目 依赖 代码 


«dependency» 
XgroupId»org.mybatis.spring.boot«/groupId» 
XartifactId»mybatis-spring-boot-starter«/artifactId» 
«version»1.3.2«/version» 

</dependency> 

<dependency> 
XgroupId»mysql«/groupId» 
XartifactId»mysql-connector-java«X/artifactlId» 
Xscope»runtime«/scope» 

</dependency> 


44.3 配置 文件 


在 配置 文件 中 需要 配置 数据 库 信 息 以 及 MyBatis 配置 。 数 据 库 配置 这 里 就 不 介绍 了 ， 关 于 
MyBatis 主要 需要 配置 以 下 几 种 。 
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* logging.level.com.dalaoyang.dao.UserMapper: 上 日志 的 打印 级 别 ， 这 里 的 com.dalaoyang.dao. 
UserMapper 是 本 文案 例 中 Mapper 的 位 置 ， 实 际 项 目 应 该 配置 对 应 Mapper 的 位 置 

* mybatis.mapper-locations:. Mapper 文件 的 存放 位 置 。 
mybatis.check-config-location: MyBatis 配置 是 否 开启 。 
mybatis.config-location: MyBatis 配置 文件 位 置 ， 与 mybatis.check-config-location 配合 使 用 。 


本 案例 对 上 述 内 容 都 进行 了 配置 ， 配 置 文 件 代 码 如 代码 清单 4-50 所 示 。 
代码 清单 4-50 ”MyBatis 项 目 配 置 文件 代码 
## 检 查 mybatis 配置 是 否 存 在 ， 一 般 命名 为 mybatis-config.xml 


mybatis.check-config-location =true 

## 配 置 文 件 位 置 
mybatis.config-location=classpath:mybatis/mybatis-config.xml 
## mapper xml 文件 地 址 

mybatis.mapper-locations-classpath* :mapper/*Mapper.xml 

## 日 志 级 别 

logging.level.com.springboot.dao.UserMapper-debug 


## 数 据 库 uri 

spring.datasource.url=jdbc:mysql://localhost:3306/test?characterEncoding= 
utf8&useSSL-false 

## 数 据 库 用 户 名 

spring.datasource.username-root 

## 数 据 库 密码 

spring.datasource.password-root 

## 数 据 库 驱 动 


spring.datasource.driver-class-name-com.mysql.jdbc.Driver 


在 src/mian/resources/mybatis 下 创建 mybatis-config.xml, 这 个 文件 是 MyBatis 的 全 局 配置 文件 ， 
包含 以 下 几 种 类 型 的 配置 : 


* properties (属性 ) 

* settings (全 局 配置 参数 ) 

© typeAliases ( 类 型 别名 ) 

* typeHandlers (类 型 处 理 器 ) 

* objectFactory (对 象 工厂 ) 

* plugins ( 插件 ) 

* environments ( 环境 集合 属性 对 象 ) 
* environment ( 环境 子 属性 对 象 ) 
* transactionManager (事务 管理 ) 
* dataSource (数据 源 ) 

* mappers (映射 器 ) 
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案例 中 仅 配置 了 一 些 常 使 用 的 类 型 别名 typeAliases，Mybatis-config.xml 内 容 如 代码 清单 4-51 
所 示 。 


MyBatis Xii El Mybatis-config 配置 代码 


<?xml version-"1.0" encoding-"UTF-8"?» 
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD SQL Map Config 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-config.dtd"» 
«configuration» 
«typeAliases» 
«typeAlias alias-"Integer" type-"java.lang.Integer" /> 
«typeAlias alias-"Long" type-"java.lang.Long" /> 
«typeAlias alias-"HashMap" type-"java.util.HashMap" /> 
«typeAlias alias-"LinkedHashMap" type-"java.util.LinkedHashMap" /> 
«typeAlias alias-"ArrayList" type-"java.util.ArrayList" /> 
«typeAlias alias-"LinkedList" type-"java.util.LinkedList" /> 
«typeAlias alias-"user" type-"com.dalaoyang.entity.User"/» 
«/typeAliases» 
«/configuration» 


创建 实体 类 User， 其 中 使 用 @Alias 注解 也 可 以 表明 类 别名 ， 代 码 如 代码 清单 4-52 所 示 。 


3 清单 4-52 MyBatis 项 目 User 实体 类 代码 


@Alias ("user") 
Public class User { 


private int id; 
private String user name; 
private String user password; 


// 省 略 set. get 方法 


4.4.4 基于 XML 的 使 用 


创建 Mapper 对 应 接口 类 UserMapper， 在 类 上 加 入 注解 @Mapper， 表 明 这 是 一 个 Mapper。 我 
们 提前 定义 5 个 方法 ， 分 别 是 : 


根据 用 户 名 查询 用 户 。 
根据 用 户 名 修改 用 户 。 
根据 用 户 名 删除 用 户 。 
保存 用 户 。 
获取 用 户 列表 。 
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UserMapper 接口 代码 如 代码 清单 4-53 所 示 。 


代码 清单 4-53 ”MyBatis mA UserMapper 类 代码 


@Mapper 
public interface UserMapper { 
User findUserByUsername (String username); 


void updateUserByUsername (User user); 
void deleteUserByUsername (String username); 
void saveUser(User user); 


List«User» getUserList(); 


在 src/mian/resources/mapper 下 创建 UserMapper.xml, X4 5j 4f E UserMapper 接口 类 的 方法 ， 
完整 内 容 如 代码 清单 4-54 所 示 。 


代码 清单 4-54 MyBatis Iii El UserMapper.xml 配置 代码 


<?xml version-"1.0" encoding-"UTF-8" ?> 
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-mapper.dtd" > 
«mapper namespace-"com.dalaoyang.dao.UserMapper"» 
«resultMap id-"user" type-"com.dalaoyang.entity.User"/» 
XparameterMap id-"user" type-"com.dalaoyang.entity.User"/» 
«select id-"findUserByUsername" parameterType-"String" 
resultMap-"user"» 
SELECT * FROM user 
WHERE user name=#{1} 
</select> 
<update id="updateUserByUsername" parameterMap="user"> 
UPDATE USER SET USER PASSWORD=#{user password} WHERE 
USER NAME-f£(user name] 
«/update» 
«delete id-"deleteUserByUsername" parameterType-"String"» 
DELETE FROM USER WHERE USER NAME=#{1} 
«/delete» 
«1-- 使 用 alias 自 定义 的 parameterType--> 
Xinsert id-"saveUser" parameterType-"user"» 
INSERT INTO USER (user password,user name) VALUES (f(user password), 
#{user name]) 
«/insert» 


<select id-"getUserList" resultMap-"user"» 


84 


| Spring Boot 2 实战 之 旅 


SELECT * FROM USER 
</select> 
</mapper> 


因为 MyBatis 深 受 很 多 公司 的 喜爱 ， 所 以 介绍 一 下 Mapper 的 标签 。 标 签 大 致 分 为 以 下 几 种 。 

(1) 定义 SQL 语句 

e inser: 多 用 于 执行 插入 语句 ， 标 签 内 有 两 个 属性 id (唯一 标识 符 ) 和 parameterType ( 传 入 的 
参数 类 型 )。 

* delete: 多 用 于 执行 删除 语句 ， 标 签 内 有 两 个 属性 id (唯一 标识 符 ) 和 parameterType (4A 
的 参数 类 型 )。 

* update: 多 用 于 执行 修改 语句 ， 标 签 内 有 两 个 属性 id ( 唯一 标识 符 ) 和 parameterType ( 传 入 
的 参数 类 型 )。 

@ select: 用 于 执行 查询 ,与 上 面 三 个 标签 相 比 ， 多 了 一 个 resultType 属性 ， 用 于 接收 返回 类 型 。 


(2) 结果 集 


* resultMap: 用 于 建立 SQL 查询 结果 字段 与 实体 属性 的 映射 关系 信息 。 
(3) 动态 SQL 拼接 


e df 用 于 判断 ， 在 test 属性 内 加 入 条 件 。 
* choose: 用 于 判断 ， 与 when 和 otherwise 配合 使 用 。 
foreach: 循环 语句 ,其 中 包含 属性 collection (KS, 内容 可 以 是 list、array 和 map)、item (4 
环 遍历 的 元 素 )、index (下 标 )、open ( 前 级 )、close ( 后 缓 )、separator (分 隔 符 )。 
(4) 格式 化 输出 


o where: 根据 标签 内 的 值 是 否 存在 自动 拼接 where 语句 。 
€ set 根据 标签 内 的 值 是 否 存在 自动 拼接 set 语句 。 
e tim: 多 用 于 灵活 去 除 多 余 关 键 字 的 标签 ， 一 般 结 合 where 或 set 使 用 。 


(5) 配置 关联 关系 


* collection: 用 于 配置 一 对 一 关系 。 
* association: 用 于 配置 一 对 多 关系 。 


(6) SQL 标签 
* sq: 主要 用 于 提取 sql 片段 ， 便 于 复 用 。 
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4.4.5 “基于 注解 使 用 


MyBatis 不 仅 可 以 使 用 XML 形式 操作 数据 库 ， 还 可 以 使 用 注解 形式 操作 数据 库 ， 比 如 如 下 
注解 。 
(QSelect: 其 中 值 写 查询 SQL. 
@Update: 其 中 值 写 修改 SQL. 
@Delete: 其 中 值 写 删 除 SQL. 
(Insert: 其 中 值 写 插入 SQL. 
@Results: 是 以 @Result 为 元 素 的 数据 。 
(QResult: 映射 实体 类 属性 和 字段 之 间 的 关系 。 
@ResultMap: 用 于 解决 返回 结果 映射 问题 ， 与 上 面 介绍 的 resultMap 标签 功能 类 似 
(Result: 可 以 用 作 表 明 自 定义 对 象 ， 方 便 内 容重 用 。 
@SelectProvider: 相当 于 直接 使 用 在 类 中 写 好 的 SQL， 将 SQL 封装 到 类 内 ， 方 便 管理 。type 
属性 表明 使 用 哪个 类 ，method 对 应 使 用 方法 。 
@UpdateProvider: 功能 类 似 于 @SelectProvider。 
* (üDeleteProvider: 功能 类 似 于 @SelectProvider。 
* (ülnsertProvider: 功能 类 似 于 @SelectProvider。 


其 实现 效果 和 使 用 XML 模式 是 一 样 的 ， 并 且 两 种 模式 可 以 混用 。 例 子 如 代码 清单 4-55 所 示 。 


代码 清单 4-55  MyBatis 项 目 基于 注解 的 代码 


GResults(( 

GResult(property - "id",column - "id"), 

@Result (property = "user name",column = "user name"), 
GResult(property = "pass word",column = "pass word") 


n 
@Select ("SELECT * FROM USER") 
List«User» findAll(); 


@SelectProvider (type = UserSqlProvider.class,method = "getSql") 
List«User» findUserById(GParam("id") int id); 


44.6 测试 运行 


前 面 对 大 部 分 使 用 场景 进行 了 介绍 ， 接 下 来 进行 测试 。 新 建 一 个 Controller， 分 别 对 刚刚 写 的 
每 一 个 数据 库 操作 写 一 个 方法 进行 测试 ， 代 码 内 容 如 代码 清单 4-56 所 示 。 


86 | Spring Boot 2 实战 之 旅 


MyBatis 项 目 UserControllei 


GRestController 
public class UserController ( 


GAutowired 
private UserMapper userMapper; 


//http://localhost:8080/getUser?username-xiaoli2 
G(GGetMapping("/getUser") 
public String getUser(String username) { 
User user -userMapper.findUserByUsername (username); 
return user!-null ? username+" 的 密码 是 : "+user.getUser password() i" 
存在 用 户 名 为 "+username+" 的 用 户 "; 
T 


/ /http://localhost:8080/updateUser?username-xiaoli2&password-123 
GGetMapping("/updateUser") 
public String updateUser(String password,String username)( 
User user = new User (username,password); 
userMapper.updateUserByUsername (user); 


return "success!"; 


/ /http://1localhost:8080/addUser?username-xiaoli2&password-123 
GGetMapping("/addUser") 
public String addUser(String username,String password) ( 
User user = new User (username,password); 
userMapper.saveUser (user); 
return "success!"; 


//http://localhost:8080/deleteUser?username-xiaoli2 

GGetMapping("/deleteUser") 

public String deleteUser(String username)( 
userMapper.deleteUserByUsername (username); 
return "success!"; 


/ /http://localhost:8080/getUserList 
GGetMapping("/getUserList") 
public List getUserList()( 

return userMapper.getUserList(); 
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//http://localhost:8080/findAll 
GGetMapping("/findAll") 
public List findAll()( 

return userMapper.findAll(); 


/ /http://localhost:8080/findUserById?id-1 
G(GetMapping("/findUserById") 
public List findUserById(int id)( 

return userMapper.findUserById(id); 


) 


有 具体 测试 可 以 在 浏览 器 上 访问 代码 中 的 注释 ， 每 一 个 方法 笔者 都 对 应 写 了 测试 地 址 ， 以 上 都 
是 笔者 亲 测 无 误 的 。 


4.4.7 Mybatis-Generator 插件 学 习 


由 于 业务 的 不 断 增长 ， 数 据 库 中 的 表 也 随 之 增长 ， 造 成 在 没 创 建 表 时 就 需要 在 项 目 内 反复 创 
建 实体 类 、Mapper 文件 、dao 层 文件 等 ， 这 样 的 重复 工作 虽然 难度 不 大 ， 但 是 会 浪费 人 力 ， 因 此 
MyBatis 创建 了 一 个 针对 这 个 问题 的 插件 Mybatis-Generator。Mybatis-Generator 是 MyBatis 官方 提 
供 的 一 个 便捷 型 插件 ， 利 用 它 可 以 根据 数据 库 表 结构 自动 在 项 目 内 创建 对 应 的 实体 类 、Mapper 文 
件 和 dao 层 。 

(1) 在 pom 文 件 中 加 入 Mybatis-Generator 插件 

在 pom 文件 中 加 入 Mybatis-Generator 插件 ， 为 了 方便 观看 ， 这 里 展示 完整 pom 文件 代码 ， 如 
代码 清单 4-57 所 示 。 


代码 清单 4-57 ”Mybatis-Generator 项 目 依赖 文件 代码 


<?xml version-"1.0" encoding="UTF-8"?> 
<project xmlns-"http://maven.apache.org/POM/4.0.0" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/xsd/maven-4.0.0.xsd"» 
«modelVersion»4.0.0«/modelVersion» 


XgroupId»com.dalaoyang«/groupId» 
«artifactId»springboot generator«/artifactId» 
«version»0.0.1-SNAPSHOT«/version» 
Xpackaging»jar«/packaging» 
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<name>chapter4.4.7</name> 
<description>chapter4.4.7</description> 


<parent> 
XgroupId»org.springframework.boot«/groupId» 
XartifactId»spring-boot-starter-parent«/artifactlId» 
«version»2.0.3.RELEASEX/version» 
XrelativePath/» «!-- lookup parent from repository --» 
«/parent» 


«properties» 
Xproject.build.sourceEncoding»UTF-8«/project.build.sourceEncoding» 
Xproject.reporting.outputEncoding»UTF-8 

«/project.reporting.outputEncoding» 
«java.version»1.8«/java.version» 
«/properties» 


«dependencies» 

«dependency» 
XgroupId»org.springframework.boot«/groupId» 
«artifactlId»spring-boot-starter-test«/artifactlId» 
X«scope»test«/scope» 

</dependency> 

<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 

</dependency> 

<dependency> 
<groupId>org.mybatis.spring.boot</groupId> 
<artifactId>mybatis-spring-boot-starter</artifactId> 
<version>1.3.1</version> 

</dependency> 

<dependency> 
<groupId>mysql</groupId> 
<artifactId>mysql-connector-java</artifactId> 
<scope>runtime</scope> 

</dependency> 

</dependencies> 


<build> 
<plugins> 
<plugin> 
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<groupId>org.mybatis .generator</groupId> 
«artifactId»mybatis-generator-maven-plugin«/artifactId» 
«version»1.3.2«/version» 

«executions» 

«execution» 
Xid»mybatis-generator«/id» 
«phase»deploy«/phase» 

«goals» 
Xgoal»generate«/goal» 
«/goals» 
«/execution» 
«/executions» 


«configuration» 


«!-- Mybatis-Generator 工具 配置 文件 的 位 置 --> 


<configurationFile>src/main/resources/mybatis-generator/ 


generatorConfig.xml</configurationFile> 
<verbose>true</verbose> 
<overwrite>true</overwrite> 
</configuration> 
<dependencies> 
<dependency> 
<groupId>mysql</groupId> 
<artifactId>mysql-connector-java</artifactId> 
<version>5.1.46</version> 
</dependency> 
<dependency> 
<groupId>org.mybatis.generator</groupId> 
<artifactId>mybatis-generator-core</artifactId> 
<version>1.3.2</version> 
</dependency> 
</dependencies> 
</plugin> 
<plugin> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-maven-plugin</artifactId> 
<configuration> 
<classifier>exec</classifier> 
</configuration> 
</plugin> 
</plugins> 
</build> 
</project> 


这 里 需要 注意 的 是 ，configurationFile 配置 的 是 Mybatis-Generator 插件 所 存放 的 位 置 ， 


本 案例 
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是 在 src/main/resources/mybatis-generator 下 创建 了 一 个 generatorConfig.xml 文件 ， 在 配置 文件 中 对 
需要 配置 的 内 容 做 了 详细 的 说 明 ， 配 置 内 容 如 代码 清单 4-58 所 示 。 


青 单 4-58 Mybatis-Generator 项 目 配 


件 


«?xml version-"1.0" encoding="UTF-8"?> 
<!DOCTYPE generatorConfiguration 
PUBLIC "-//mybatis.org//DTD MyBatis Generator Configuration 1.0//EN" 
"http://mybatis.org/dtd/mybatis-generator-config 1 0.dtd"» 
<!-- 配置 生成 器 --> 
XgeneratorConfiguration» 
<!--H4T generator 插件 生成 文件 的 命令 : callmvnmybatis-generator:generate -e 


<!-- 引入 配置 文件 --> 

<properties resource="application.properties"/> 

<!--classPathEntry :数据库 的 JDBC 驱动 ， 换 成 你 自己 的 驱动 位 置 ， 可 选 --> 

<!--<classPathEntry location="D:\generator mybatis\mysql-connector- 
java-5.1.24-bin.jar" /> --> 


<!-- 一 个 数据 库 一 个 context --» 
<!--defaultModelType="flat" 大 数据 字段 ， 不 分 表 --> 
<context id="MysqlTables" targetRuntime="MyBatis3Simple" 
defaultModelType="flat"> 
<!-- 自动 识别 数据 库 关键 字 ， 默 认为 false， 如 果 设 置 为 true， 就 根据 
SqlReservedWords 中 定义 的 关键 字 列表 。 一 般 保 留 默认 值 ， 遇 到 数据 库 关 键 字 〈Java 关键 字 ) 时 ， 
使 用 columnOverride 覆盖 --> 
Xproperty name-"autoDelimitKeywords" value-"true" /> 
«1-- 生成 的 Java 文件 的 编码 --> 
<property name="javaFileEncoding" value="utf-8" /> 
<!-- beginningDelimiter 和 endingDelimiter: 指明 数据 库 中 用 于 标记 数据 库 对 象 
名 的 符号 ， 比 如 ORACLE 就 是 双 引 号 ，MySQL 默认 是 `〈 反 引号 ) --» 


<property name="beginningDelimiter" value: 


DEA 

<property name-"endingDelimiter" value-"^" /> 

<!-- 格式 化 java 代 码 --> 

<property name-"javaFormatter" value-"org.mybatis.generator. 
api.dom.DefaultJavaFormatter"/» 

«t-- 格式 化 XML 代码 --> 

<property name-"xmlFormatter" value-"org.mybatis.generator. 
api.dom.DefaultXmlFormatter"/» 

Xplugin type-"org.mybatis.generator.plugins.SerializablePlugin" /> 


«plugin type-"org.mybatis.generator.plugins.ToStringPlugin" /> 


<!-- 注释 --> 
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XcommentGenerator > 
«property name-"suppressAllComments" value-"false"/»«!-- 是 否 取消 
注释 --> 
«property name-"suppressDate" value-"true" /> «!-- 是 否 生成 注释 带 时 
间 惟 --> 


</commentGenerator> 


<!-- jdbc 连接 --> 
<jdbcConnection driverClass-"$(spring.datasource.driver-class-name]" 
connectionURL-"$(spring.datasource.url])" userId- 
"$(spring.datasource.username]" password-"$(spring.datasource.password]" /> 
<!-- 类 型 转换 --> 
«javaTypeResolver» 
<!-- 是 否 使 用 bigDecimal， false 可 自动 转化 为 其 他 类 型 (Long. Integer. 
Short 等 ) --> 
<property name-"forceBigDecimals" value="false"/> 
«/javaTypeResolver» 


<!-- 生成 实体 类 地 址 --> 
<javaModelGenerator targetPackage-"com.dalaoyang.entity" 
targetProject-"$ (mybatis.project]" > 
«property name-"enableSubPackages" value-"false"/» 
«property name-"trimStrings" value-"true"/» 
«/javaModelGenerator» 
«1-- 生成 mapxml 文件 --> 
XsqlMapGenerator targetPackage-"mapper" targetProject- 
"$(mybatis.resources])" > 
<property name-"enableSubPackages" value="false" /> 
«/sqlMapGenerator» 
<!-- 生成 mapxml 对 应 client， 也 就 是 接口 dao --» 
<javaClientGenerator targetPackage-"com.dalaoyang.dao" 
targetProject-"$(mybatis.project)" type-"XMLMAPPER" > 
<property name-"enableSubPackages" value="false" /> 
«/javaClientGenerator» 
«1-- table 可 以 有 多 个 ， 每 个 数据 库 中 的 表 都 可 以 写 一 个 table，tableName 表示 要 苞 
配 的 数据 库 表 ， 也 可 以 在 tableName 属性 中 通过 使 用 $ 通 配 符 来 匹配 所 有 数据 库 表 ， 只 有 匹配 的 表 才 会 
自动 生成 文件 --> 
«table tableName-"user" enableCountByExample-"true" 
enableUpdateByExample-"true" enableDeleteByExample-"true" 
enableSelectByExample-"true" selectByExampleQueryId-"true"» 
<property name-"useActualColumnNames" value="false" /> 
<!-- 数据 库 表 主键 --> 
<generatedKey column="id" sqlStatement="Mysql" identity="true" /> 
</table> 
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</context> 
</generatorConfiguration> 


在 Mybatis-Generator 中 有 部 分 数据 这 里 读 取 的 是 application.properties 文件 中 的 内 容 。 下 面 给 
出 application.properties 文件 中 的 配置 ， 如 代码 清单 4-59 所 示 。 


代码 清单 4-59 Mybatis-Generator 项 目 配置 文件 代码 


## mapper xml 文件 地 址 


mybatis.mapper-locations-classpath* :mapper/*Mapper.xml 


## 数 据 库 url 

spring.datasource.url-jdbc:mysql://localhost:3306/test?characterEncoding- 
utf8&useSSL-false 

## 数 据 库 用 户 名 

spring.datasource.username=root 

## 数 据 库 密码 

spring.datasource.password-123456 

## 数 据 库 驱动 


spring.datasource.driver-class-name-com.mysql.jdbc.Driver 


#Mybatis Generator configuration 
dao 类 和 实体 类 的 位 置 
mybatis.project =src/main/java 
#mapper 文件 的 位 置 


mybatis.resources=src/main/resources 


到 这 里 ， 其 实 就 已 经 配置 完成 了 。 接 下 来 我 们 查看 Intelli] IDEA 中 ，Maven 的 工具 栏 ， 可 以 
看 到 已 经 安装 了 Mybatis-Generator 插件 ， 如 图 4-15 所 示 。 
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图 4-15 Mybatis-Generator 项 目 插件 示例 图 


我 们 看 一 下 Maven 操作 日 志 ， 提 示 已 经 生成 了 dao 层 、 实 体 类 、Mapper 文件 ， 如 图 4-16 所 示 。 
去 对 应 目录 看 看 ， 果 然 这 些 都 生成 了 ， 如 图 4-17 所 示 。 
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图 4-17 Mybatis-Generator 项 目 结构 示例 图 


我 们 再 来 查看 一 下 Mapper， 其 实在 Mapper 内 已 经 默认 生成 了 几 个 简单 的 方法 ， 让 我 们 看 一 
下 UserMapper 接口 的 内 容 ， 代 码 如 代码 清单 4-60 所 示 。 


代码 清单 4-60 Myba r 项 目 UserMappet 


public interface UserMapper { 
/** 
* This method was generated by MyBatis Generator. 
* This method corresponds to the database table user 
* 
* Qmbggenerated 
E 
int deleteByPrimaryKey (Long id); 
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yA 
* This method was generated by MyBatis Generator. 
* This method corresponds to the database table user 


* Qmbggenerated 

x 

int insert(User record); 

/** 

* This method was generated by MyBatis Generator. 

* This method corresponds to the database table user 
* 

* (mbggenerated 

exi 

User selectByPrimaryKey (Long id); 


"E 
* This method was generated by MyBatis Generator. 

* This method corresponds to the database table user 
* 

* (mbggenerated 

WA 

List<User> selectAll(); 


/** 
* This method was generated by MyBatis Generator. 
* This method corresponds to the database table user 
* 
* Q(mbggenerated 
ey 
int updateByPrimaryKey (User record); 
} 


UserMapper.xml 也 对 应 写 好 了 SQL， 代 码 内 容 如 代码 清单 4-61 所 示 。 


<?xml version-"1.0" encoding-"UTF-8" ?> 
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-mapper.dtd" > 
«mapper namespace-"com.dalaoyang.dao.UserMapper" > 
«resultMap id-"BaseResultMap" type-"com.dalaoyang.entity.User" > 
Si 
WARNING - Gmbggenerated 
This element is automatically generated by MyBatis Generator, do not 
modify. 
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--» 
Xid column-"id" property-"id" jdbcType-"BIGINT" /» 
«result column-"user name" property-"userName" jdbcType-"VARCHAR" /> 
«result column-"user password" property-"userPassword" 
jdbcType-"VARCHAR" /» 
«/resultMap» 
«delete id-"deleteByPrimaryKey" parameterType-"java.lang.Long" > 
Ex 
WARNING - Gmbggenerated 
This element is automatically generated by MyBatis Generator, do not 
modify. 
--» 
delete from user 
where id = f(id,jdbcType-BIGINT) 
«/delete» 
«insert id-"insert" parameterType-"com.dalaoyang.entity.User" > 
<!-- 
WARNING - Gmbggenerated 
This element is automatically generated by MyBatis Generator, do not 
modify. 
--» 
XselectKey resultType-"java.lang.Long" keyProperty-"id" order-"AFTER" > 
SELECT LAST INSERT ID() 
«/selectKey» 
insert into user (user name, user password) 
values (f(userName,jdbcType-VARCHAR), $(userPassword, jdbcType-VARCHAR]) 
«/insert» 
«update id-"updateByPrimaryKey" 
parameterType-"com.dalaoyang.entity.User" > 
dh 
WARNING - Gmbggenerated 
This element is automatically generated by MyBatis Generator, do not 
modify. 
--» 
update user 
set user name = £(userName, jdbcType-VARCHAR), 
user password = f£(userPassword, jdbcType-VARCHAR) 
where id = f£(id,jdbcType-BIGINT) 
«/update» 
<select id-"selectByPrimaryKey" resultMap-"BaseResultMap" parameterType- 
"java.lang.Long" » 
Sies 
WARNING - @mbggenerated 
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This element is automatically generated by MyBatis Generator, do not 
modify. 
--» 
select id, user name, user password 
from user 
where id = f(id,jdbcType-BIGINT]) 
</select> 
<select id="selectAll" resultMap="BaseResultMap" > 
sier 
WARNING - @mbggenerated 
This element is automatically generated by MyBatis Generator, do not 
modify. 
--» 
Select id, user name, user password 
from user 
</select> 
</mapper> 


这 些 自动 生成 的 方法 都 是 可 以 直接 使 用 的 ， 可 以 使 用 在 Controller 内 对 应 的 写 方法 测试 ， 也 可 
以 使 用 测试 用 例 测试 ， 这 里 就 不 一 一 测试 了 。 


4.4.8 PageHelper 插件 


在 操作 数据 库 的 时 候 ， 分 页 是 必 不 可 少 的 一 项 任务 ,在 使 用 MyBatis 时 ， 可 以 利用 PageHelper 
插件 对 MyBatis 插件 进行 分 页 。 PageHelper 支持 常见 的 12 种 数据 库 , 如 Oracle, MySQL, MariaDB, 


SQLite、DB2、PostgreSQL、SQL Server 等 。 
在 pom 文件 中 加 入 PageHelper 依赖 ， 依 赖 代码 如 代码 清单 4-62 所 示 。 


代码 清单 4-62 Mybatis-PageHelper 项 目 依赖 文件 代码 


<!--pagehelper --> 
<dependency> 
<groupId>com.github.pagehelper</groupId> 
<artifactId>pagehelper-spring-boot-starter</artifactId> 
<version>1.2.5</version> 


</dependency> 


配置 文件 除了 MySQL 配置 外 , 还 添加 了 一 个 PageHelper 插件 的 配置 ,也 就 是 配置 SQL 方言 ， 
配置 如 代码 清单 4-63 所 示 。 


代码 清单 4-63 Mybatis-PageHelper 项 目 配置 文件 代码 


#pagehelper 分 页 插件 配置 
pagehelper.helperDialect-mysql 
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实体 类 和 之 前 的 一 样 ， 这 里 就 不 反复 介绍 了 。 由 于 PageHelper 插件 只 是 用 于 分 页 ， 因 此 我 们 
只 是 在 Mapper 内 用 注解 写 了 一 个 查询 所 有 用 户 的 方法 ， 如 代码 清单 4-64 所 示 。 


代码 清单 4-64 Mybatis-PageHelper mA UserMapper 类 代码 


@Mapper 
Public interface UserMapper { 


@Select ("SELECT * FROM USER") 
List«User» getUserListPage(); 
) 


使 用 PageHelper 其 实 特别 方便 ， 只 要 引入 PageHelper 类 ， 然 后 设置 页 码 和 每 页 的 数量 即 可 ， 
案例 测试 代码 如 代码 清单 4-65 所 示 。 


代码 清单 4-65 Mybatis-PageHelper Iii El UserController 类 代码 


GRestController 
public class UserController ( 


GAutowired 
private UserMapper userMapper; 


/ /http://localhost:8080/getUserListPage?pageNum-1&pageSize-2 
GGetMapping("getUserListPage") 
public List«User» getUserListPage(Integer pageNum, Integer pageSize)( 
PageHelper.startPage(pageNum, pageSize); 
return userMapper.getUserListPage(); 


) 


启动 项 目 ， 在 浏览 器 上 访问 http;/localhost:8080/getUserListPage?pageNum-l&pageSize-2, iX 
里 pageNum 为 页 码 、pageSize 为 每 页 的 数量 。 是 不 是 很 简单 ? 接 下 来 我 们 介绍 一 个 更 全 面 的 插件 。 


4.4.9 Mybatis-Plus 插件 


Mybatis-Plus 是 苞 米 豆 团 队 开发 的 一 个 MyBatis 增强 型 插件 , 官网 上 介绍 只 做 增强 , 不 做 改变 ， 
为 简化 开发 、 提 高 效率 而 生 。 其 特性 有 很 多 ， 这 里 不 一 一 介绍 ， 感 兴趣 的 读者 可 以 在 官网 上 查看 ， 
官网 地 址 : https://mp.baomidou.com/。 

接 下 来 我 们 学 习 Spring Boot 如 何 使 用 Mybatis-Plus 插件 。 新 建 项 目 ， 在 pom 文件 中 加 入 
Mybatis-Plus 依赖 ， 完 整 pom 文件 依赖 如 代码 清单 4-66 所 示 。 


98 | Spring Boot 2 实战 之 旅 


代码 清单 4-66 Mybatis-Plus 项 目 依赖 文件 f 


<dependencies> 

«dependency» 
XgroupId»org.springframework.boot«/groupId» 
XartifactId»spring-boot-starter-web«/artifactId» 

</dependency> 

<dependency> 
<groupId>com.baomidou</groupId> 
<artifactId>mybatisplus-spring-boot-starter</artifactId> 
<version>1.0.5</version> 

</dependency> 

<dependency> 
<groupId>com.baomidou</groupId> 
<artifactId>mybatis-plus</artifactId> 
<version>2.3</version> 

</dependency> 

<dependency> 
<groupId>mysql</groupId> 
<artifactId>mysql-connector-java</artifactId> 
<scope>runtime</scope> 

</dependency> 

<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-test</artifactId> 
<scope>test</scope> 

</dependency> 

</dependencies> 


接 下 来 在 配置 文件 中 配置 mapper.xml 文件 的 位 置 和 type-aliases 实体 的 位 置 ， 配置 如 代码 清单 
4-67 所 示 。 


代码 清单 4-67 ”Mybatis-Plus 项 目 配置 文件 代码 


##mybatis-plus mapper xml 文件 地 址 
mybatis-plus.mapper-locations-classpath* :mapper/*Mapper.xml 
##mybatis-plus type-aliases 文件 地 址 
mybatis-plus.type-aliases-package-com.dalaoyang.entity 


实体 类 还 是 使 用 之 前 的 User 类 ， 可 以 复制 过 来 ， 新 建 一 个 Mybatis-Plus 配置 类 
MybatisPlusConfig， 在 这 里 可 以 设置 一 些 方言 的 配置 等 ， 代 码 如 代码 清单 4-68 所 示 。 


代码 清单 4-68 Mybatis-Plus 项 目 MybatisPlusConfig 类 代码 


GConfiguration 
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public class MybatisPlusConfig ( 
GBean 
public PaginationInterceptor paginationInterceptor()í 
PaginationInterceptor page - new PaginationInterceptor(); 
// 设 置 方言 类 型 
page.setDialectType ("mysql"); 
return page; 


) 


XT dao 层 ， 这 里 我 们 需要 继承 Mybatis-Plus 提供 的 BaseMapper， 只 在 里 面 写 一 个 查询 用 户 
列表 CgetUserList) 的 方法 ， 代 码 如 代码 清单 4-69 所 示 。 


代码 清单 4-69  Mybatis-Plus mA UserMapper 类 代码 


GMapper 

public interface UserMapper extends BaseMapper«User? | 
List«User» getUserList(); 

li 


在 Mapper.xml 内 写 出 对 应 方法 ， 如 代码 清单 4-70 所 示 。 


代码 清单 4-70 Mybatis-Plus 项 目 Mapper.xml 代码 


<?xml version-"1.0" encoding-"UTF-8" ?> 
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-mapper.dtd" > 
«mapper namespace-"com.dalaoyang.dao.UserMapper"» 
«resultMap id-"user" type-"com.dalaoyang.entity.User"/» 
XparameterMap id-"user" type-"com.dalaoyang.entity.User"/» 


«select id-"getUserList" resultMap-"user"» 
SELECT * FROM USER 
</select> 
</mapper> 


最 后 使 用 Controller 进行 测试 ， 方 法 介绍 如 下 。 

* getUserlist: 尝试 使 用 传统 MyBatis 方法 ， 若 可 以 使 用 ， 则 证 明 Mybatis-Plus 插件 没有 影响 原 
有 使 用 。 

* getUserLisiByName: 使 用 Mybatis-Plus 提供 的 selectByMap 方法 ， 参 数 是 Map， 在 Map 内 写 
入 查询 条 件 。 
saveUser: 使 用 Mybatis-Plus 提供 的 insert 方法 ， 参 数 使 用 对 应 实体 即 可 ， 返 回 影响 行 数 。 
updateUser: 使 用 Mybatis-Plus 提供 的 insert 方法 ， 参 数 使 用 对 应 实体 (A ID) 即 可 ， 返 回 影 


响 行 数 。 
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* getUserListByPage: 使 用 Mybatis-Plus 提供 的 selectPage 方法 ， 这 是 一 个 条 件 分 页 查询 方法 ， 
需要 用 到 Mybatis-Plus 的 对 象 EntityWrapper 存放 查询 条 件 ， 使 用 Page 来 存放 分 页 信息 。 
关于 测试 Mybatis-Plus 的 完整 Controller 代码 如 代码 清单 4-71 所 示 。 


代码 清单 4-71 Mybati 


lus 项 目 依赖 文件 


GRestController 
public class UserController ( 
GAutowired 


private UserMapper userDao; 


/ /http://localhost:8080/getUserList 

GGetMapping("getUserList") 

public List«User» getUserList()( 
return userDao.getUserList(); 


/ /http://localhost:8080/getUserListByName?userName-xiaoli 
// 条 件 查询 
@GetMapping ("getUserListByName") 
public List<User> getUserListByName (String userName) 
t 
Map map - new HashMap(); 
map.put("user name", userName); 
return userDao.selectByMap (map); 


//http://localhost:8080/saveUser?userName-xiaoli&userPassword-111 
// 保 存 用 户 
GGetMapping("saveUser") 
public String saveUser(String userName,String userPassword) 
t 

User user - new User(userName,userPassword); 

Integer index - userDao.insert (user); 

if (index>0) { 

return "新 增 用 户 成 功 。"; 
}else{ 


return "新 增 用 户 失败 。"; 


/ /http://localhost:8080/updateUser?id-5&userName-xiaoli&userPassword-111 
// 修 改 用 户 
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GGetMapping("updateUser") 
public String updateUser (Integer id,String userName,String userPassword) 
i 

User user - new User(id,userName,userPassword); 

Integer index = userDao.updateById (user); 

if (index?0)( 

return "修改 用 户 成 功 ， 影 响 行 数 "+index+" 行 。"; 
}else{ 


return "修改 用 户 失 败 ， 影 响 行 数 "+index+" 行 。"; 


//http://localhost:8080/getUserById?userId=1 
// 根 据 Id 查询 User 

GGetMapping ("getUserById") 

public User getUserById(Integer userId) 

i 


return userDao.selectById (userId); 


//http://localhost:8080/getUserListByPage?pageNumber=1&pageSize=2 
// 条 件 分 页 查询 
QGetMapping("getUserListBYPage") 
public List<User> getUserListByPage (Integer pageNumber, Integer pageSize) 
i 
Page<User> page -new Page<> (pageNumber,pageSize); 
EntityWrapper«User» entityWrapper = new EntityWrapper«»(); 
entityWrapper.eq("user name", "xiaoli"); 
return userDao.selectPage (page,entityWrapper); 


45 配置 多 数据 源 


什么 是 数据 源 ? 

数据 源 是 提供 某 种 所 需要 数据 的 器 件 或 原始 媒体 。 在 数据 源 中 存储 了 所 有 建立 数据 库 连 接 的 
信息 。 就 像 通过 指定 文件 名 称 可 以 在 文件 系统 中 找到 文件 一 样 , 通过 提供 正确 的 数据 源 名 称 可 以 找 
到 相应 的 数据 库 连 接 。 本 节 将 对 多 数据 源 进行 学 习 。 
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4.5.1 多 数据 源 情况 分 析 


什么 是 多 数据 源 ? 从 字面 意思 来 看 ， 其 实 就 是 使 用 多 个 数据 源 方 法 的 多 个 数据 库 ， 数 据 源 和 
数据 库 是 一 对 一 的 关系 。 这 时 ， 我 们 会 遇 到 另 一 个 问题 ， 为 什么 不 用 一 个 数据 库 来 解决 问题 ， 而 要 
分 那么 多 数据 源 呢 ? 接 下 来 我 们 一 起 来 探讨 。 

1. 为 什么 要 使 用 多 数据 源 


这 个 问题 其 实 和 为 什么 要 分 库 的 中 心思 想 是 一 致 的 。 随 着 业务 的 发 展 ， 数 据 库 中 的 数据 量 和 
数据 表 越 来 越 多 ， 对 数据 库 的 操作 〈 增 、 删 、 改 、 查 ) 开销 越 来 越 大 ， 最 后 可 能 导致 所 在 服务 器 的 
资源 被 占用 ， 如 服务 器 CPU 被 严重 占用 。 因 此 ， 多 数据 源 出 现 了 ， 将 数据 库 分 成 多 个 ， 将 压力 分 
散 开 来 ， 减 小 数据 库 的 压力 。 

2. 如 何 分 多 数据 源 

一 般 情 况 下 ， 分 数据 源 大 致 有 两 种 : 

e ”垂直 切 分 。 所 谓 重 直 切 分 ,我 们 可 以 理解 为 根据 业务 功能 分 成 多 个 数据 库 。 以 商城 系统 为 例 ， 

有 商品 模块 、 用 户 模块 、 订 单 模块 ， 可 能 还 有 记录 日 志 的 数据 表 等 ， 以 上 几 个 模块 可 以 分 为 
GoodsDb ( 商品 数据 库 )、UserDb ( 用 户 数据 库 )、OrderDb ( 订单 数据 库 )、LogDb (日 志 数 
据 库 )。 

e 水 平 切 分 。 水 平 切 分 一 般 来 说 是 根据 数据 量 来 分 的 ， 比 如 一 个 数据 库 的 数据 量 特别 大 的 话 ， 

我 们 可 以 按 某 种 规则 将 数据 库 分 为 多 个 ， 比 如 按 年 份 ， 年 份 较 近 的 优先 对 待 。 
3. 多 数据 源 的 好 处 是 什么 
多 数据 源 有 如 下 好 处 : 


o 数据 逻辑 清晰 ， 维 护 方便 ， 对 应 数据 源 所 包含 的 数据 都 是 同业 务 类 型 的 。 
o 减 小 数据 库 的 压力 ， 降 低 服务 器 的 负载 ， 让 原来 同一 台 机 器 的 压力 分 散 开 来 。 


4.5.2 配置 多 数据 源 


前 面 介绍 了 使 用 多 数据 源 的 原因 , 接 下 来 我 们 一 起 来 学 习 Spring Boot 是 如 何 使 用 多 数据 源 的 。 
首先 介绍 有 关 多 数据 源 的 配置 ， 比 如 我 们 有 两 个 数据 源 : test 和 test2， 需 要 在 配置 文件 中 进行 
数据 库 对 应 的 配置 ， 如 代码 清单 4-72 所 示 。 


代码 清单 4-72 ”多 数据 源 项 目 配置 文件 代码 


## test 数据 源 

## 数 据 库 url 

spring.datasource.test.jdbc-url-jdbc:mysql://localhost:3306/test?characte 
rEncoding-utf8&useSSL-false 


## 数 据 库 用 户 名 
spring.datasource.test.username-root 
## 数 据 库 密码 
spring.datasource.test.password-root 
## 数 据 库 驱动 


spring.datasource.test.driver-class-name-com.mysql.jdbc.Driver 


## test2 数据 源 

HR EE uri 

spring.datasource.test2.jdbc-url-jdbc:mysql://localhost:3306/test2?charac 
terEncoding-utf8&useSSL-false 

## 数 据 库 用 户 名 

spring.datasource.test2.username-root 

## 数 据 库 密码 

spring.datasource.test2.password-root 

## 数 据 库 驱动 


spring.datasource.test2.driver-class-name-com.mysql.jdbc.Driver 


注意 多 数据 源 与 单数 据 源 配置 的 不 同 ， 之 前 单数 据 源 数据 库 是 直接 配置 spring.datasource. 
password， 这 次 在 spring.datasource 后 面 加 了 一 个 数据 源 名 称 。 

配置 好 数据 源 之 后 ， 新 建 一 个 数据 源 配置 类 ， 用 于 接收 刚刚 的 配置 参数 ， 这 里 需要 使 用 
@Primary 注解 表明 哪个 是 主 数据 源 ， 内 容 如 代码 清单 4-73 所 示 。 


代码 清单 4-73 ”多 数据 源 项 目 DataSourceConfig 类 代码 


GConfiguration 
public class DataSourceConfig ( 
@Bean (name = "testDataSource") 
GQualifier("testDataSource") 
GPrimary 
GConfigurationProperties (prefix-"spring.datasource.test") 
public DataSource primaryDataSource() ( 
return DataSourceBuilder.create().build(); 
b 


@Bean (name = "test2DataSource") 
GQualifier("test2DataSource") 
GConfigurationProperties (prefix-"spring.datasource.test2") 
public DataSource secondaryDataSource() ( 

return DataSourceBuilder.create().build(); 


) 


接 下 来 需要 对 每 个 数据 源 进行 详细 配置 。 这 里 以 test] 数据 源 为 例 ， 其 中 详细 配置 当前 数据 源 
的 实体 类 位 置 、 数 据 库 信息 等 ， 如 代码 清单 4-74 所 示 。 
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代码 清单 4-74 ”多 数据 源 项 目 TestDataSourceConfig 


GConfiguration 
QEnableTransactionManagement 
QGEnableJpaRepositories( 
entityManagerFactoryRef-"entityManagerFactoryPrimary", 
transactionManagerRef-"transactionManagerPrimary", 
basePackages- ( "com.springboot.repository.datasource" ]) 
public class TestDataSourceConfig { 
GAutowired 
GQualifier("testDataSource") 
private DataSource dataSource; 


GPrimary 
@Bean (name = "entityManagerPrimary") 
public EntityManager entityManager (EntityManagerFactoryBuilder builder)( 
return entityManagerFactoryPrimary (builder) .getObject(). 
createEntityManager(); 
} 


@Primary 

@Bean (name = "entityManagerFactoryPrimary") 

public LocalContainerEntityManagerFactoryBean entityManagerFactoryPrimary 

(EntityManagerFactoryBuilder builder) { 
return builder 

-dataSource (dataSource) 
.properties (getVendorProperties ()) 
.packages ("com.springboot.entity.datasource") 
// 设 置 实体 类 所 在 位 置 
.persistenceUnit ("primaryPersistenceUnit") 
.build(); 


GAutowired 
private JpaProperties jpaProperties; 


private Map«String, Object» getVendorProperties() ( 
return jpaProperties.getHibernateProperties (new HibernateSettings ()); 


GPrimary 

@Bean (name = "transactionManagerPrimary") 

Public PlatformTransactionManager transactionManagerPrimary 
(EntityManagerFactoryBuilder builder) ( 
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return new JpaTransactionManager (entityManagerFactoryPrimary 
(builder).getObject()); 
H 


) 


4.5.8 dT JPA 使 用 多 数据 源 


有 关 JPA 的 使 用 之 前 已 经 介绍 很 多 了 , 接 下 来 使 用 JPA 测试 前 面 的 多 数据 源 是 否 生效 。 在 pom. 
文件 加 入 依赖 ， 分 别 创建 两 个 实体 类 ， 其 中 City 对 应 数据 源 test 的 对 应 实体 类 位 置 ，House 对 应 数 
据 源 test2 的 对 应 实体 类 位 置 。 启 动 项 目 ， 观 察 控制 台 和 数据 库 ， 可 以 看 到 在 test 数据 库 中 创建 了 
City 表 ， 在 City 数据 库 中 创建 了 House 表 。 实 体 类 内 容 如 代码 清单 4-75 和 4-76 所 示 。 


代码 清单 4-75 多 数据 源 项 目 City 类 代码 


GEntity 
QTable (name="city") 
Public class City { 


@Id 
@GeneratedValue (strategy=GenerationType.IDENTITY 


private int cityId; 
private String cityName; 
private String cityIntroduce; 


// 省 略 set. get 方法 


代码 清单 4-76 ”多 数据 源 项 目 House 类 代码 


GEntity 
Table (name-"house") 
public class House ( 


@Id 

@GeneratedValue (strategy-GenerationType.IDENTITY) 
private int houseId; 

private String houseName; 

private String houseIntroduce; 


// 省 略 set. get 方法 
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接 下 来 分 别 创建 City 实体 和 House 实体 对 应 的 数据 操作 层 ， 内 容 如 代码 清单 4-77 和 4-78 
所 示 。 


代码 清单 4-77 ”多 数据 源 项 目 CityRepositroy 类 代码 


public interface CityRepository extends JpaRepository<City, Integer> { 
4 


代码 清单 4-78 ”多 数据 源 项 目 HouseRepository 类 代码 


public interface HouseRepository extends JpaRepository<House Integer> ( 


) 


新 建 一 个 controller， 并 且 在 类 内 创建 一 个 新 增 的 方法 ， 分 别 对 两 个 数据 源 进行 操作 ， 代 码 如 
代码 清单 4-79 所 示 。 


代码 清单 4-79 ”多 数据 源 项 目 TestController 类 代码 


@RestController 
public class TestController { 


GAutowired 
CityRepository cityRepository; 


GAutowired 
HouseRepository houseRepository; 


GGetMapping("/testDataSource") 

public String testDataSource()( 
City city = new City(" 北 京 "," 中 国 首 都 ") ; 
cityRepository.save (city); 
House house = new House ("豪宅 ", "特别 大 的 豪宅 ") ; 
houseRepository.save (house); 
return "success"; 


在 浏览 器 上 访问 http://localhost:8080/testDataSource， 可 以 看 到 分 别 在 两 个 数据 库 中 插入 了 数 
据 ， 其 他 JPA 操作 同样 能 够 进行 。 感 兴趣 的 读者 可 以 当 作 一 次 复习 ， 巩 国 一 下 JPA 的 使 用 。 


4.5.4 基于 MyBatis 使 用 多 数据 


复制 前 面 的 项 目 , 将 JPA 依赖 修改 为 MyBatis。 再 使 用 MyBatis 对 4.5.3 小 节 的 场景 进行 复 现 ， 
对 MyBatis 复习 一 遍 。 还 是 使 用 4.5.3 小 节 的 实体 类 对 象 ， 新 建 CityMapper 和 HouseMapper， 分 别 
利用 注解 写 两 个 查询 方法 ， 即 查询 所 有 City 和 House， 代 码 如 代码 清单 4-80 和 4-81 所 示 。 
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代码 清单 4-80 ”多 数据 源 项 目 CityMapper 类 代码 


GMapper 

public interface CityMapper ( 
@Select ("SELECT * FROM City") 
List«City» getAllCity(); 


代码 清单 4-81 多 数据 源 项 目 HouseMapper 类 代码 


GMapper 
public interface HouseMapper ( 
@Select ("SELECT * FROM House") 


List«House» getAllHouse(); 


使 用 MyBatis 操作 多 数据 源 与 JPA 的 配置 略 有 不 同 ， 如 代码 清单 4-82 所 示 。 


代码 清单 4-82 ”多 数据 源 项 目 HouseMapper 类 代码 


GConfiguration 
GMapperScan(basePackages = "com.springboot.mapper.datasource", 


SqlSessionTemplateRef - "sqlSessionTemplatePrimary") 
public class TestDataSourceConfig ( 
@Bean (name = "sqlSessionFactoryPrimary") 
GPrimary 
public SqlSessionFactory masterSqlSessionFactory (GQualifier 
("testDataSource") DataSource dataSource) throws Exception ( 
SqlSessionFactoryBean bean = new SqlSessionFactoryBean(); 
bean.setDataSource (dataSource); 
// 如 果 使 用 xml 5j SQL 的 话 在 这 里 配置 
//bean.setMapperLocations (new PathMatchingResourcePatternResolver(). 
getResources ("classpath:mapper/datasource/*.xml")); 
return bean.getObject(); 


@Bean (name = "transactionManagerPrimary") 


GPrimary 
public DataSourceTransactionManager masterDataSourceTransactionManager 


(GQualifier("testDataSource") DataSource dataSource) ( 
return new DataSourceTransactionManager (dataSource); 


@Bean (name = "sqlSessionTemplatePrimary") 


GPrimary 
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public SqlSessionTemplate masterSqlSessionTemplate ((QQualifier 
("sqlSessionFactoryPrimary") SqlSessionFactory sqlSessionFactory) ( 
return new SqlSessionTemplate (sqlSessionFactory); 


) 


本 文 是 使 用 注解 的 方式 执行 的 SQL， 如 果 使 用 XML 方式 写 SQL 的 话 需要 使 用 
setMapperLocations 方法 进行 设置 。 


使 用 TestController 进行 测试 ， 如 代码 清单 4-83 所 示 。 


代码 清单 4-83 ”多 数据 源 项 目 TestController 代码 


GRestController 
public class TestController ( 


GAutowired 


HouseMapper houseMapper; 


GAutowired 
CityMapper cityMapper; 


GGetMapping("/testDataSource") 

public Map testDataSource()( 
Map map - new HashMap(); 
List«City» cityList-cityMapper.getAllCity(); 
List«House» houseList-houseMapper.getAllHouse(); 
map.put("cityList",cityList); 
map.put ("houseList",houseList); 
return map; 


) 


使 用 浏览 器 访问 http://localhost:8080/testDataSource， 可 以 看 到 在 使 用 JPA 时 插入 的 数据 。 


4.6 使 用 Druid 数据 库 连 接 池 


4.6.1 Druid 简介 


Druid 是 Java 语言 中 最 好 的 数据 库 连 接 池 , 是 阿里 巴巴 的 一 个 开源 项 目 , 作为 一 个 优秀 的 数据 
库 连 接 池 ，Druid 提供 了 优秀 的 稳定 性 ， 并 且 在 性 能 方面 比 其 他 数据 库 连 接 提 高 了 很 多 ， 最 重要 的 
是 Druid 提供 了 实时 监控 功能 ， 如 数据 源 监控 、SQL 监控 、SQL 防火 墙 、Web 应 用 监控 、URI W 
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控 、Session 监控 、Spring 监控 等 。 正 如 Druid 官网 Chttp://druid.io/2 介绍 的 那样 : Druid 主要 用 于 
存储 、 查 询 和 分 析 大 型 事件 流 。 所 谓 分 析 大 型 事件 流 ， 就 是 前 面 介绍 的 监控 功能 ， 接 下 来 会 一 一 
介绍 。 


4.6.2 配置 Druid 


在 pom 文件 中 加 入 Druid 依赖 、MySQL 依赖 以 及 JPA 依赖 ， 依 赖 代码 如 代码 4-84 所 示 。 


代码 清单 4-84 Druid 项 目 依赖 代码 


<dependencies> 

<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-data-jpa</artifactId> 

</dependency> 

<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 

</dependency> 

<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-devtools</artifactId> 
<scope>runtime</scope> 

</dependency> 

<dependency> 
<groupId>mysql</groupId> 
<artifactId>mysql-connector-java</artifactId> 
<scope>runtime</scope> 

</dependency> 

<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-test</artifactId> 
<scope>test</scope> 

</dependency> 

<dependency> 
<groupId>com.alibaba</groupId> 
<artifactId>druid-spring-boot-starter</artifactId> 
<version>1.1.16</version> 

</dependency> 

</dependencies> 


接 下 来 需要 对 配置 文件 进行 配置 ，Druid 的 配置 有 很 多 ， 如 代码 清单 4-85 所 示 。 


110 | Spring Boot 2 实战 之 旅 


代码 清单 4-85 ”多 数据 源 项 目 配置 文件 代码 


## 数 据 库 配 置 

## 数 据 库 地 址 

spring.datasource.url-jdbc:mysql://localhost:3306/test?characterEncoding- 
utf8&useSSL-false 

## 数 据 库 用 户 名 

spring.datasource.username-root 

## 数 据 库 密码 

spring.datasource.password-root 

## 数 据 库 驱动 


spring.datasource.driver-class-name-com.mysql.jdbc.Driver 


# 这 里 是 不 同 的 
HER druid 的 话 ， 需 要 多 配置 一 个 属性 spring.datasource.type 


spring.datasource.type-com.alibaba.druid.pool.DruidDataSource 


# 连接 池 的 配置 信息 

# 初始 化 大 小 ， 最 小 或 最 大 

spring.datasource.initialSize-5 

spring.datasource.minIdle-5 

spring.datasource.maxActive-20 

# 配置 获取 连接 等 待 超时 的 时 间 

spring.datasource.maxWait-60000 

# 配置 间隔 多 久 才 进行 一 次 检测 ， 检 测 需 要 关闭 的 空闲 连接 ， 单 位 是 毫秒 
spring.datasource.timeBetweenEvictionRunsMillis-60000 

# 配置 一 个 连接 在 池 中 最 小 生存 的 时 间 ， 单 位 是 毫秒 
spring.datasource.minEvictableIdleTimeMillis-300000 
spring.datasource.validationQuery-SELECT 1 FROM DUAL 
spring.datasource.testWhileIdle-true 
spring.datasource.testOnBorrow-false 
spring.datasource.testOnReturn-false 

# 打开 PSCache， 并 且 指定 每 个 连接 上 PSCache 的 大 小 
spring.datasource.poolPreparedStatements-true 
spring.datasource.maxPoolPreparedStatementPerConnectionSize-20 
# 配置 监控 统计 拦截 的 filters， 去 掉 后 监控 界面 sql 无 法 统计 ，wal1 用 于 防火 墙 


spring.datasource.filters-stat,wall,log4j 


与 多 数据 源 类 似 ， 需 要 创建 一 个 配置 文件 接收 Druid 配置 ， 代 码 如 代码 清单 4-86 所 示 。 


代码 清单 4-86 多 数据 源 项 目 DruidConfig 类 代码 


GConfiguration 


public class DruidConfig ( 
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GValue("$(spring.datasource.url]") 
private String dbUrl; 


(Value ("$(spring.datasource.username]") 


private String username; 


GValue("$(spring.datasource.password]") 


private String password; 


GValue("$(spring.datasource.driver-class-name]") 
private String driverClassName; 


(Value ("$(spring.datasource.initialSize)") 


private int initialSize; 


@Value ("$(spring.datasource.minIdle]") 


private int minIdle; 


GValue("$(spring.datasource.maxActive]") 
private int maxActive; 


GValue("$(spring.datasource.maxWait]") 
private int maxWait; 


GValue("$(spring.datasource.timeBetweenEvictionRunsMillis]") 
private int timeBetweenEvictionRunsMillis; 


Q&Value("$(spring.datasource.minEvictableIdleTimeMillis]") 
private int minEvictableIdleTimeMillis; 


GValue("$(spring.datasource.validationQuery)") 
private String validationQuery; 


GValue("$(spring.datasource.testWhileIdle]") 
private boolean testWhileIdle; 


GValue("$(spring.datasource.testOnBorrow]") 
private boolean testOnBorrow; 


(Value ("$(spring.datasource.testOnReturn)") 
private boolean testOnReturn; 
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GValue("$(spring.datasource.poolPreparedStatements]") 
private boolean poolPreparedStatements; 


GValue ("S$(spring.datasource. maxPoolPreparedStatementPerConnectionSize]") 
private int maxPoolPreparedStatementPerConnectionSize; 


G&Value("$(spring.datasource.filters]") 
private String filters; 


GValue("(spring.datasource.connectionProperties])") 


private String connectionProperties; 


GBean 
GPrimary // 主 数据 源 
public DataSource dataSource()í 
DruidDataSource datasource - new DruidDataSource(); 


datasource.setUrl(this.dbUrl); 
datasource.setUsername (username); 
datasource.setPassword (password); 
datasource.setDriverClassName (driverClassName); 


//configuration 

datasource.setlInitialSize(initialSize); 

datasource.setMinIdle (minIdle); 

datasource.setMaxActive (maxActive); 

datasource.setMaxWait (maxWait); 

datasource.setTimeBetweenEvictionRunsMillis 
(timeBetweenEvictionRunsMillis); 

datasource.setMinEvictableIdleTimeMillis 
(minEvictableIdleTimeMillis); 

datasource.setValidationQuery (validationQuery); 

datasource.setTestWhileIdle (testWhileIdle); 

datasource.setTestOnBorrow (testOnBorrow); 

datasource.setTestOnReturn (testOnReturn); 

datasource.setPoolPreparedStatements (poolPreparedStatements); 

datasource.setMaxPoolPreparedStatementPerConnectionSize 
(maxPoolPreparedStatementPerConnectionSize); 

try { 

datasource.setFilters(filters); 
) catch (SQLException e) ( 
H 
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datasource.setConnectionProperties (connectionProperties); 


return datasource; 


) 
新 建 一 个 Druid 的 过 滤器 ， 用 于 过 滤 一 些 静态 文件 ， 代 码 如 代码 清单 4-87 所 示 。 


代码 清单 4-87 ”多 数据 源 项 目 TestController 代码 


GWebFilter(filterName-"druidWebStatFilter",urlPatterns-"/*", 


initParams-( 
GWebInitParam(name-"exclusions",value-"*.js,*.gif,*.jpg, 


*.bmp, *.png, *.css, *.ico,/druid/*") // ZU IE RI 


) 


) 
public class DruidFilter extends WebStatFilter 


H 
新 建 DruidServlet， 这 个 类 继承 StatViewServlet， 用 于 过 滤 管 理 页 面 IP 等 信息 ， 代 码 如 代码 清 


{ 


单 4-88 所 示 。 


代码 清单 4-88 ”多 数据 源 项 目 DruidServlet 类 代码 


QWebServlet (urlPatterns-"/druid/*", 


initParams-( 
GWebInitParam(name-"allow",value-""), 


// IP 白 名 单 ( 若 没 有 配置 或 者 为 空 ， 则 人 允许 所 有 访问 ) 


@WebInitParam (name="deny", value=""), 
// IP 黑 名 单 (deny 优先 于 allow) 


@WebInitParam (name="loginUsername",value="admin"), 


// 登录 druid 管理 页 面 用 户 名 


@WebInitParam (name="loginPassword",value="admin") 


// 登录 druid 管理 页 面 密码 


n 
public class DruidServlet extends StatViewServlet ( 


) 
这 次 需要 注意 的 是 ,要 在 启动 类 上 加 入 @ServletComponentScan, 否则 无 法 扫描 到 DruidServlet 


启动 类 代码 如 代码 清单 4-89 所 示 。 


代码 清单 4-89 ”多 数据 源 项 目 SpringBootDruidApplication 代码 


GSpringBootApplication 
// 启动 类 必须 加 入 @ServletcomponentScan 注解 ， 否 则 无 法 扫描 到 servlet 


@ServletComponentScan 
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public class SpringbootDruidApplication ( 


public static void main(String[] args) ( 
SpringApplication.run(SpringbootDruidApplication.class, args); 


4.6.3 ”操作 数据 库 
这 里 以 JPA 操作 数据 库 为 例 创建 一 个 实体 类 User， 如 代码 清单 4-90 所 示 。 


代码 清单 4-90 ”多 数据 源 项 目 City 实体 类 代码 


GEntity 
GTable (name-"city") 
public class City ( 


@Id 
GGeneratedValue (strategy-GenerationType.IDENTITY) 
private int cityId; 

private String cityName; 

private String cityIntroduce; 


。// 省 略 set. get 方法 


) 


接 下 来 分 别 创建 Repository 和 Controller 进行 测试 ， 这 里 就 不 具体 解释 了 ， 代 码 分 别 如 代码 清 
单 4-91 和 代码 清单 4-92 所 示 。 


代码 清单 4-91 多 数据 源 项 目 CityRepository 类 代码 


public interface CityRepository extends JpaRepository<City, Integer> { 
} 


代码 清单 4-92 ”多 数据 源 项 目 CityController 类 代码 


@RestController 
public class CityController { 


GAutowired 
private CityRepository cityRepository; 


@GetMapping (value = "saveCity") 
public String saveCity(String cityName,String cityIntroduce)(í 
City city - new City(cityName,cityIntroduce); 


cityRepository.save (city); 
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return "success"; 


$ 


//http://localhost:8888/deleteCity?cityId=2 
@GetMapping (value = "deleteCity") 
public String deleteCity(int cityId)( 
cityRepository.delete (cityId); 
return "success"; 


} 


@GetMapping (value = "updateCity") 

public String updateCity (int cityId,String cityName, String cityIntroduce)( 
City city = new City(cityId,cityName,cityIntroduce); 
cityRepository.save (city); 
return "success"; 


b 


GGetMapping(value = "getCityById") 
public City getCityById(Integer cityId)( 
City city = cityRepository.findOne(cityId); 


return city; 


) 


启动 项 目 ， 访 问 对 应 链接 测试 ， 这 里 不 再 袭 述 ， 和 之 前 的 一 样 。 


4.6.4 Druid 监控 页 面 介绍 


1. 登录 页 


因为 项 目 结合 了 Druid， 所 以 我 们 可 以 访问 http://localhost:8080/druid， 如 图 4-18 所 示 。 


图 4-18 Druid 项 目 Druid 监控 登录 页 面 
2. 首页 
使 用 用 户 名 admin、 密 码 admin 登录 后 ， 可 以 看 到 如 图 4-19 所 示 的 页 面 。 
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Da aa TAZ mes onse ama woe mas ses io za EENNEEEEEEDE 


Stat Index 查看 JSON API 


图 4-19 Druid MA Druid 首页 
从 图 4-19 中 可 以 看 到 ， 首 页 包含 如 下 信息 。 


版 本 : Druid 版 本 。 

驱动 : 包含 Druid 驱动 、 MySQL 驱动 等 。 

是 否 允 许 重 置 。 

重 置 次 数 。 

Java 版 本 。 

jvm 名 称 。 

classpath 路 径 : 这 里 是 本 机 配置 的 环境 变量 ， 由 于 笔者 的 电脑 配置 了 太 多 环境 变量 ， 因 此 导 
致 这 一 张 图 没有 展示 完全 。 

e 启动 时 间 : 项 目的 启动 时 间 。 

3. 数据 源 页 面 


接 下 来 ， 在 菜单 栏 单 击 数据 源 菜单 ， 会 展示 很 多 配置 ， 基 本 上 都 是 与 数据 源 配 置信 息 相 关 的 ， 
如 果 含 有 多 个 数据 源 , 就 会 显示 多 个 Tab Ji. Druid 更 加 友好 的 是 在 最 后 一 列 对 当前 行进 行 了 介绍 ， 
具体 如 图 4-20~ 图 4-23 所 示 。 
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图 422 Druid 监控 -数据 源 图 三 
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4. SQL 监控 页 面 


单 击 菜单 栏 的 SQL 监控 菜单 ， 进 入 SQL 监控 页 面 ， 一 开始 是 没有 数据 的 ， 这 时 我 们 请 求 两 次 
服务 ， 然 后 刷新 页 面 ， 可 以 看 到 页 面 如 图 4-24 所 示 。 


Er lq 

SQL Stat View JSON API maals a EL 
anem: anassa — annom aso 

N sav L3 Iu (s Poo [ur 


424 Druid 监控 -SQL 监控 页 面 
在 图 中 显示 了 每 条 SQL 的 执行 次 数 、 时 间 、 事 务 、 最 慢 SQL、 最 大 并 发 、 读 取 行 数 等 信息 ， 
并 且 可 以 根据 每 一 列 的 条 件 进行 正 序 或 者 倒叙 排序 ， 这 很 有 利于 我 们 对 系统 SQL 进行 问题 排查 及 
优化 。 


5. SQL 防火 墙 页 面 


这 个 页 面 有 针对 数据 库 的 保护 策略 ， 可 以 看 到 表 访 问 统计 、 白 名 单 、 黑 名 单 等 数据 访问 情况 ， 
如 图 4-25 和 图 4-26 所 示 。 
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425 Druid 监控 -SQL 防火 墙 页 面 图 一 
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函数 调用 统计 


SQL 防御 统计 - 白 名 单 
SQL 防御 统计 - 黑 名 单 


426 Druid 监控 -SQL 防火 墙 页 面 图 二 
6. Web 应 用 页 面 


Web 应 用 页 面 主要 用 于 实时 分 析 数 据 库 的 访问 情况 ， 如 正在 执行 多 少 SQL、 最 大 并 发 、 事 务 
等 ， 这 里 只 截取 了 一 张 图 片 供 参考 ， 感 兴趣 的 读者 可 以 自行 研究 ， 如 图 4-27 所 示 。 


2; 


se c^ ^ WXBEZEZIB 
WebAppStat List View JSON API 


图 4-27 Druid 监控 -Web 应 用 页 面 
7. URI 监控 页 面 


URI 监控 页 面 主要 用 于 监控 对 系统 的 请 求 ， 内 容 大 致 和 前 几 个 监控 差不多 ， 有 事务 、 执 行 数 、 
并 发 等 ， 如 图 4-28 所 示 。 


428 Druid 监控 -URI 监控 页 面 
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8. Session 监控 页 面 


Session 监控 页 要 用 于 监控 系统 内 Session 的 使 用 情况 , 由 于 本 项 目 没有 使 用 , 因此 这 里 没 
有 数据 ， 如 图 4-29 所 示 。 


Druid Montor SA MES 。 SQL 监控 SOUPE Wema URINI | Sesscr 监 控 ^ spingiE! JSONAPI GESI 
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powered by AibabaTecn & sandzhang & mein & ervek wang 


4-29 Druid 监控 -Session 监控 页 面 -无 数据 


我 们 修改 一 下 getCityByld 方法 , 将 查询 出 来 的 city WA Session， 这 里 的 使 用 可 能 不 恰当 , 仅 
仅 是 为 了 查看 Session 监控 页 面 的 数据 ， 如 代码 清单 4-93 所 示 。 


代码 清单 4-93 Druid WA getCityByld 方法 改造 


@GetMapping (value = "getCityById") 

public City getCityById(Integer cityId, HttpServletRequest request){ 
Optional«City» optionalCity = cityRepository.findById(cityId); 
HttpSession session - request.getSession(); 
City city - optionalCity.isPresent() ? optionalCity.get() : null; 
session.setAttribute (cityId.toString(),city); 
return city; 


) 


然后 查看 Session, Au 4-30 所 示 ， 可 以 看 到 一 条 Session 数据 。 


[Da ES 记录 E "1 
Englah | 中 
Web Session Stat View JSON API mssu 5 EI 
ARA BRAR OBS BAF Jæ bo WA Aa ADF RM 
N session pnneipal mam ABUSE omot BO è ma — 3 x UR — "HO wa 39 n n 
1 EB7E4600C2OD/QDGGS4F2CS E260Có? zown — 20010 — 00000004 1 — 4 0$ oh 5 1 
205405 2:405 


powered by AlbabaTech & sandzang & mein & shrek wang 
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9. Spring 监控 页 面 


Spring 监控 页 面 主要 用 于 监控 系统 内 Spring 的 使 用 情况 ， 由 于 本 项 目 没有 使 用 ， 因 此 这 里 没 
有 数据 ， 如 图 4-31 所 示 。 
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Fd 4-31 Druid 监控 -Spring 监控 页 面 
10. JSON API 


JSON API 页 面 其 实 就 是 对 Druid 监控 的 一 些 说 明 ， 如 图 4-32 所 示 。 
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4-32. Druid 监控 -JSON API 页 面 
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本 章 对 Spring Boot 使 用 数据 库 进行 了 全 面 的 介绍 ， 从 简单 的 数据 库 配 置 到 现在 特别 流行 的 
JPA 和 MyBatis 的 使 用 都 进行 了 详尽 的 介绍 , 相信 你 已 经 对 操作 数据 库 有 了 一 定 的 认识 ,并且 熟练 
运用 ， 可 以 独立 进行 开发 了 。 


Spring Boot 的 缓存 之 旅 


第 4 章 我 们 学 习 了 数据 库 的 使 用 ， 但 是 数据 库 并 不 能 完全 高 性 能 地 解决 任何 事情 ， 这 个 时 候 
缓存 就 出 现 了 。 缓 存 这 个 词 对 于 很 多 人 来 说 可 能 并 不 陌生 , 无 论 是 从 事 传统 项 目的 开发 者 ， 还 是 互 
联网 项 目的 开发 者 ， 可 能 都 对 缓存 有 一 定 的 了 解 。 缓 存 数据 交换 的 缓冲 区 ， 一 般 来 说 会 将 访问 量 比 
较 大 的 数据 从 数据 库 中 查询 出 来 放 入 缓存 中 ， 当 下 次 获取 数据 的 时 候 , 直接 从 缓存 中 获取 。 通 常 组 
存 会 放 入 内 存 或 硬盘 中 ， 方 便 开发 者 使 用 。 本 章 将 对 Spring Boot 如 何 使 用 缓存 进行 学 习 。 


5.1 使 用 Spring Cache 


5.1.1 Spring Cache 简介 


Spring Cache 是 Spring 3.1 以 后 引入 的 新 技术 。 它 并 不 像 正常 缓存 那样 存储 数据 ， 其 核心 思想 
是 这 样 的 : 当 我 们 在 调用 一 个 缓存 方法 时 , 会 把 该 方法 参数 和 返回 结果 作为 一 个 键 值 对 存放 在 缓存 
H, 等 到 下 次 利用 同样 的 参数 来 调用 该 方法 时 将 不 再 执行 该 方法 ,而 是 直接 从 缓存 中 获取 结果 进行 
返回 ， 从 而 实现 缓存 的 功能 。Spring Cache 的 使 用 和 Spring 对 于 事务 管理 的 使 用 类 似 ， 可 以 基于 注 
解 使 用 或 者 基于 XML 配置 方式 使 用 。 下 面 我 们 来 学 习 基于 注解 的 使 用 。 

在 Spring 中 提供 了 3 个 注解 来 使 用 Spring Cache， 下 面 分 别 进行 介绍 。 


1. @Cacheable 


@Cacheable 注解 用 于 标记 缓存 , 也 就 是 对 使 用 @Cacheable 注解 的 位 置 进行 缓存 。@Cacheable 
可 以 在 方法 或 者 类 上 进行 标记 ， 当 对 方法 进行 标记 时 ， 表 示 此 方法 支持 缓存 ， 当 对 类 进行 标记 时 ， 
表明 当前 类 中 所 有 的 方法 都 支持 缓存 。 在 支持 Spring Cache 的 环境 下 ， 对 于 使 用 @Cacheable 标记 
的 方法 ，Spring 在 每 次 调用 方法 前 都 会 根据 key 查询 当前 Cache 中 是 否 存在 相同 key 的 缓存 元 素 ， 
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如 果 存 在 ， 就 不 再 执行 该 方法 ， 而 是 直接 从 缓存 中 获取 结果 进行 返回 ， 否 则 执行 该 方法 并 将 返回 结 
果 存 入 指定 的 缓存 中 。 在 使 用 @Cacheable 时 通常 会 搭配 3 个 属性 进行 使 用 ， 分 别 介绍 如 下 。 
* value: 在 使 用 @Cacheable 注解 的 时 候 , value 属性 是 必须 要 指定 的 , 这 个 属性 用 于 指定 Cache 
的 名 称 ， 也 就 是 说 ， 表 明 当前 缓存 的 返回 值 用 于 哪个 缓存 上 。 
* key: 和 名 称 一 样 ， 用 于 指定 缓存 对 应 的 key. key 属性 不 是 必须 指定 的 ， 如 果 我 们 没有 指定 
key, Spring 就 会 为 我 们 使 用 默认 策略 生成 的 key。 其 中 默认 策略 是 这 样 规 定 的 : 如 果 当 前 缓 
存 方法 没有 参数 ， 那 么 当前 key 为 0; 如 果 当 前 缓存 方法 有 一 个 参数 ， 那 么 以 key 为 参数 值 ; 
如 果 当 前 缓存 方法 有 多 个 参数 ， 那 么 key 为 所 有 参数 的 hashcode 值 。 当 然 ， 我 们 也 可 以 通过 
Spring 提供 的 EL 表达 式 来 指定 当前 缓存 方法 的 key。 通 常 来 说 ， 我 们 可 以 使 用 当前 缓存 方法 
的 参数 指定 key， 一 般 为 “# 参 数 名 ”。 如 果 参 数 为 对 象 ， 就 可 以 使 用 对 象 的 属性 指定 key， 比 
如 使 用 之 前 的 User 类 ， 使 用 方式 如 代码 清单 5-1 所 示 。 


代码 清单 5-1 使 用 类 属性 作为 @Cacheable 注解 key 属性 


@Cacheable (value="users", key="#user.id") 
public User findUser(User user) ( 
return new User(); 


) 


同时 ,Spring 框架 还 为 我 们 提供 了 root 对 象 来 使 用 key 属性 ,在 指定 key 属性 时 可 以 忽略 #oot， 
因为 Spring 默认 调用 的 就 是 root 对 象 的 属性 。 其 中 root 对 象 分 别 内 置 如 下 几 个 属性 。 


(1) methodName: 当前 方法 的 名 称 ，key fti Jy#root.methodName 或 methodName。 

(2) method: 指定 当前 方法 ，key 值 为 #root.method.name 或 method.name。 

(3) target: 当前 被 调用 的 对 象 ，key 值 为 #root.target 或 target。 

(4) targetClass: 当前 被 调用 的 对 象 的 class, key 值 为 #oot.targetClass 或 targetClass。 

(5) args: 当前 方法 参数 组 成 的 数组 ，key 值 为 折 oot.args[0] 或 args[0] 。 

(6)caches: 当前 被 调用 的 方法 使 用 的 Cache; key 值 为 机 oot.caches[0].name 或 caches[0].name。 

* condition: 主要 用 于 指定 当前 缓存 的 触发 条 件 。 很 多 情况 下 可 能 并 不 需要 使 用 所 有 缓存 的 方 

法 进行 缓存 ， 所 以 Spring Cache 为 我 们 提供 了 这 种 属性 来 排除 一 些 特定 的 情况 。 以 属性 指定 
key 为 userid 为 例 ， 比 如 我 们 只 需要 id 为 偶数 才 进 行 缓存 , 进行 配置 condition 属性 的 过 程 如 
代码 清单 5-2 所 示 。 


代码 清单 5-2 ”使 用 类 属性 作为 @Cacheable 注解 condition 属性 


@Cacheable (value="users", key="#user.id" , condition="#user.id%2==0") 
public User findUser(User user) { 
return new User(); 


) 
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2. (QCachePut 


从 名 称 上 来 看 ，@CachePut 只 是 用 于 将 标记 该 注解 的 方法 的 返回 值 放 入 缓存 中 ， 无 论 缓存 中 
是 否 包含 当前 缓存 ， 只 是 以 键 值 的 形式 将 执行 结果 放 入 缓存 中 。 在 使 用 方面 ，@CachePut 注解 和 
@Cacheable 注解 一 致 ， 这 里 就 不 具体 介绍 了 。 


3. @CacheEvict 


Spring Cache 提供 了 @CacheEvict 注解 用 于 清除 缓存 数据 ， 与 @Cacheable 类 似 ， 不 过 
@CacheEvict 用 于 方法 时 清除 当前 方法 的 缓存 ,用 于 类 时 清除 当前 类 所 有 方法 的 缓存 。@CacheEvict 
除了 提供 与 @Cacheable 一 致 的 3 个 属性 外 ， 还 提供 了 一 个 常用 的 属性 allEntries， 这 个 属性 的 默认 
值 为 false， 如 果 指 定 属性 值 为 tue， 就 会 清除 当前 value 值 的 所 有 缓存 。 


5.1.2 ”配置 Spring Cache 依赖 


创建 一 个 项 目 ， 在 项 目 中 加 入 spring-boot-starter-cache 依赖 ， 因 为 配合 数据 库 操 作 缓存 才 会 更 
加 明显 ， 所 以 加 入 JPA 和 MySQL 进行 测试 ， 依 赖 代码 如 代码 清单 5-3 所 示 。 


代码 清单 5-3 Spring Cache 项 目 依赖 文件 代码 


<dependencies> 

<dependency> 
XgroupId»org.springframework.boot«/groupId» 
Xartifactld»spring-boot-starter-cache«/artifactId» 

«/dependency» 

<dependency> 
XgroupId»org.springframework.boot«/groupId» 
X«artifactId»spring-boot-starter-data-jpaX/artifactId» 

</dependency> 

<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 

</dependency> 

«dependency» 
XgroupId»mysql«/groupId» 
«artifactlId»mysql-connector-java«/artifactlId» 
Xscope»runtime«/scope» 

</dependency> 

<dependency> 
XgroupId»org.springframework.boot«/groupId» 
«artifactld»spring-boot-starter-test«/artifactlId» 
Xscope»test«/scope» 

«/dependency» 

«/dependencies» 
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5.1.3 ”测试 运行 


配置 文件 内 容 与 使 用 JPA 操作 数据 库 的 配置 一 样 ,实体 类 可 以 复制 第 4 章 使 用 的 User 实体 类 ， 
数据 库 操作 层 只 是 简单 地 继承 了 JpaRepository， 代 码 就 不 在 这 里 展示 了 。 需 要 注意 的 是 , 我 们 需要 
在 启动 类 上 加 入 @EnableCaching 注解 ， 表 明 启 动 缓存 ， 启 动 类 代码 如 代码 清单 5-4 所 示 。 


代码 清单 5-4 Spring Cache 项 目 启动 类 代码 


GSpringBootApplication 
// 开 启 缓存 
GEnableCaching 
public class SpringbootCacheApplication ( 
public static void main(String[] args) ( 
SpringApplication.run(SpringbootCacheApplication.class, args); 


) 


还 是 一 如 既往 地 使 用 Controller 进行 测试 。 首 先 看 一 段 代 码 ， 然 后 对 代码 进行 解释 ， 示 例 代码 
比较 简单 ， 并 没有 使 用 Service 编写 代码 ， 正 常 开 发 过 程 中 是 需要 Service 和 Impl 类 对 代码 进行 规 
范 的 。 示 例 代码 如 代码 清单 5-5 所 示 。 


代码 清单 5-5 Spring Cache 项 目 UserController 类 代码 


GRestController 
public class UserController ( 


GAutowired 
private UserRepository userRepository; 


GGetMapping("/saveUser") 

@CachePut (value = "user", key = "#id") 

public User saveUser(Long id, String userName, String userPassword)( 
User user - new User(id,userName, userPassword); 
userRepository.save (user); 
return user; 


) 


GGetMapping("/queryUser") 

GCacheable (value = "user", key = "fid") 
public Optional«User» queryUser(Long id)í 
return userRepository.findById(id); 

H 


GGetMapping("/deleteUser") 
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GCacheEvict (value = "user", key - "#id") 
public String deleteUser (Long id){ 
userRepository.deleteById(id); 
return "success"; 


f 


@GetMapping ("/deleteCache") 
GCacheEvict(value = "user", allEntries = true) 
public void deleteCache() ( 
) 
} 


对 代码 清单 5-5 进行 分 析 ， 其 中 包含 4 个 方法 、3 个 注解 ， 分 别 说 明 如 下 。 


(1) saveUser 方法 : 其 中 使 用 到 @CachePut， 将 返回 值 存放 于 缓存 中 。 

(2) queryUser 方法 : 其 中 使 用 到 @Cacheable， 这 个 注解 在 执行 前 会 查看 是 否 已 经 存在 缓存 ， 
如 果 存在 ， 就 直接 返回 ， 如果 不 存在 ， 就 将 返回 值 存 入 缓存 后 再 返回 。 

(3) deleteUser 方法 : 其 中 使 用 到 @CacheEvict， 用 于 删除 对 应 的 缓存 。 

(4) deleteCache 方法 : 与 deleteUser 方法 类 似 ， 不 过 这 个 例子 配置 了 allEntries 属性 ， 用 于 删 
除 所 有 value 为 user 的 缓存 。 


5.1.4 ”验证 缓存 


验证 一 : @CachePut 注解 存储 缓存 


介绍 完 注解 ， 接 着 就 要 验证 了 。 先 在 浏览 器 上 访问 http://localhost:8080/saveUser?id= 
1&userName=dalaoyang&userPassword=123， 保 存 一 个 id 为 1 的 用 户 ， 刚 刚 介绍 了 ， 这 个 注解 会 将 
返回 值 存 入 缓存 ，@CachePut 注解 验证 完成 。 


验证 二 : @Cacheable 注解 存储 缓存 和 查询 缓存 


接 下 来 ， 我 们 清空 控制 台数 据 ， 因 为 在 配置 文件 中 设置 了 打印 SQL， 如 果 查 询 数据 库 ， 就 会 
在 控制 台 打 印 SQL; 如 果 使 用 缓存 ， 就 会 没有 显示 。 接 下 来 在 浏览 器 上 访问 http://localhost:8080/ 
queryUser?id=1， 观 看 控制 台 发 现 没 有 任何 日 志 ， 证 明 缓 存 生 效 了 。 

接 下 来 我 们 在 数据 库 中 插入 一 条 ID 为 2 的 User 数据 。 继 续 验 证 @Cacheable 注解 ， 第 一 次 访 
li) http://localhost:8080/queryUser?id=2， 控 制 台 打印 了 SQL, 第 二 次 访问 没有 打印 , 证 明 缓 存 生效 ， 
@Cacheable 验证 完成 。 

验证 三 : @CacheEvict 注解 清除 缓存 

接 下 来 验证 @CacheEvict 注解 ， 我 们 调用 http://localhost:8080/deleteUser?id=1 删除 ID 为 1 的 
用 户 ， 再 查询 它 ， 发 现 打印 了 SQL. 证 明 缓存 已 经 删除 。 最 后 调用 http://localhost:8080/deleteCache 


删除 全 部 缓存 ， 再 访问 http://localhost:8080/queryUser?id=2， 发 现 打印 了 SQL, @CacheEvict 注解 
验证 完成 。 
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由 于 验证 比较 简单 ， 因 此 只 给 出 了 文字 验证 说 明 ， 感 兴趣 的 读者 可 以 自己 结合 更 多 场景 进行 


5.2 使 用 Redis 


5.2.1 Redis 简介 


Redis 是 一 个 高 性 能 的 缓存 存储 系统 ， 并 且 以 Key-Value 的 形式 存储 数据 。 目 前 Value 支持 5 
种 数据 类 型 ， 其 中 包括 sting (字符 串 ) 、list EK) ~ set (集合) 、zset Csorted set, AFRA) 
和 hash〈 哈 希 类 型 ) Redis 支持 多 种 开发 语言 ， 如 Java、C/C++、C#、PHP、JavaScript、Perl、 
Objective-C、Python、Ruby、Erlang 等 。 同 时 ，Redis 还 支持 数据 的 持久 化 ， 不 只 可 以 将 数据 存储 
在 内 存 中 ， 还 可 以 将 数据 存储 到 硬盘 内 ， 不 需要 担心 数据 的 丢失 。 在 性 能 方面 ，Redis 官方 (官网 
地 址 : https://redis.io/) 提供 了 这 样 的 数据 : 读 的 速度 是 110 000 次 /s， 写 的 速度 是 81 000 次 /s， 是 
一 个 真正 的 高 性 能 数据 库 。 

5.1 节 简 单 介绍 了 有 关 Spring Boot 使 用 Redis 方面 相关 的 依赖 及 配置 ， 本 节 将 具体 学 习 Spring 
Boot 对 于 Redis 的 使 用 。 


522 ”项目 配置 


在 创建 项 目 之 前 ,需要 启动 Redis。 启 动 Redis 后 ， 新 建 项 目 ， 在 pom 文件 中 加 入 Redis 依赖 ， 
依赖 代码 如 代码 清单 5-6 所 示 。 


代码 清单 5-6 Spring Boot 使 用 Redis 项 目 依赖 文件 代码 


<dependencies> 

<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-data-redis</artifactId> 

«/dependency» 

«dependency» 
XgroupId»org.springframework.boot«/groupId» 
X«artifactlId»spring-boot-starter-web«/artifactId» 

«/dependency» 

«dependency» 
XgroupId»org.springframework.boot«/groupId» 
X«artifactId»spring-boot-starter-test«/artifactId» 
X«scope»test«/scope» 

</dependency> 

</dependencies> 
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在 配置 文件 中 配置 Redis 信息 , 这 里 我 们 只 配置 Redis 服务 地 址 和 端口 , 如 代码 清单 5-7 所 示 。 


代码 清单 5-7 Spring Boot 使 用 Redis 项 目 依 赖 文 件 代 码 


# Redis 服务 器 地 址 
spring.redis.host-localhost 
# Redis 服务 器 连接 端口 
spring.redis.port-6379 


对 于 使 用 Redis， 常 用 操作 无 非 就 是 set 方法 和 get 方法 ， 所 以 我 们 创建 一 个 RedisService 对 这 
两 个 操作 进行 提取 ， 在 类 上 加 入 @Service， 表 明 这 是 一 个 受 Spring 管理 的 JavaBean 对 象 ， 在 
RedisService 类 内 注入 RedisTemplate， 用 于 对 Redis 缓存 进行 操作 。 创 建 两 个 方法 : Set 方法 和 Get 
方法 ， 分 别 用 于 使 用 RedisTemplate 进行 存放 数据 和 取出 数据 ， 如 代码 清单 5-8 所 示 。 


代码 清单 5-8 Spring Boot 使 用 Redis 项 目 RedisService SHA 


@Service 
public class RedisService { 
GResource 
private RedisTemplate«String,Object» redisTemplate; 


public void set(String key, Object value) ( 
ValueOperations«String,Object» vo = redisTemplate.opsForValue(); 
vo.set(key, value); 


public Object get(String key) ( 
ValueOperations«String,Object» vo = redisTemplate.opsForValue(); 
return vo.get (key); 


) 


还 是 使 用 之 前 的 User 实体 类 。 接 下 来 创建 一 个 UserController 进行 测试 ,分 别 调用 RedisService 
内 的 Set 方法 和 Get 方法 ， 内 容 比 较 简单 ， 直 接 看 代码 即 可 ， 如 代码 清单 5-9 所 示 。 


代码 清单 5-9 Spring Boot 使 用 Redis 项 目 UserController 类 代码 


GRestController 

public class UserController ( 
GAutowired 
private RedisService redisService; 


GGetMapping(value = "saveUser") 
public String saveUser(Long id,String userName,String userPassword)( 
User user - new User(id,userName,userPassword); 


redisService.set(id.toString(),user); 
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return "success"; 


) 


@GetMapping (value = "getUserById") 
public Object getUserById(Long id){ 
return redisService.get(id.toString()); 


) 


5.2.3 ”测试 运行 


启动 项 目 ， 访 问 http;/localhost:S080/saveUser?id-1 &userName=dalaoyang&userPassword=123， 查 看 
控制 台 发 现 报 错 了 。 

根据 控制 台 提 示 分 析 ， 原 因 是 我 们 没有 对 实体 类 进行 序列 化 ， 对 实体 类 进行 序列 化 后 重启 项 
目 ， 再 次 访问 发 现 可 以 保存 了 。 接 下 来 查看 一 下 Redis 数据 库 ， 发 现 值 虽然 存 进来 了 ， 但 是 编码 格 
式 似乎 不 对 ， 如 图 所 5-1 所 示 。 


oee redis-4.0.8 — redis-cli — 80x24 
127.0.0.1:6379» keys * 


1) "AxacNvxedNx60Nx05tNx0ONx011 " 
127.0.0.1:6379» 


图 5-1 redis-cli 查看 图 一 


从 图 5-1 中 可 以 看 出 ，Redis 存 入 的 key 编码 有 一 些 问题 。 接 下 来 我 们 修改 一 下 set 方法 ， 将 
key 值 进行 序列 化 ， 修 改 set 方法 后 的 代码 如 代码 清单 5-10 所 示 。 


代码 清单 5-10 Spring Boot 使 用 Redis MA set 方法 修改 后 代码 


public void set(String key, Object value) ( 
// 在 redis 里 面 查看 key 编码 问题 
redisTemplate.setKeySerializer(new StringRedisSerializer()); 
ValueOperations«String,Object^ vo = redisTemplate.opsForValue(); 
vo.set(key, value); 

} 


和 新 启动 项 目 ， 为 了 保证 效果 清晰 ， 先 使 用 flushall (这 个 指令 用 于 清空 Redis 的 所 有 key) 清 


# 


空 key， 再 调用 刚刚 保存 的 方法 ， 这 时 使 用 redis-cli 查看 刚刚 保存 的 key， 如 图 5-2 所 示 。 


oeo redis-4.0.8 — redis-cli — 80x24 
127.0.0.1:6379> keys * 


D 
127.0.0.1:6379» 


5-2 redis-cli 查看 图 二 
接 下 来 在 redis-cli 中 查看 key 为 1 的 值 ， 使 用 命令 get 1 获取 key 为 1 的 数据 ， 如 图 5-3 所 示 。 
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127.0.0.1:6379» get 1 
"\xac\xed\x@0\x@5sr\x00\x19com. dal aoyang .entity.User\xclWNNY\x89 Nx90vAx02 x00 x 
983L\x0@\x02idt\x@@\x10Ljava/lang/Long;L\x8@\buserNamet x00 Nx12L java/lang/String; 


LWxGONxOcuserPas swordqNx00-Nx00Nx02xps rxx80 xe java. Lang. Long; \x8b\xe4\x90\xcc\x 
BFENXdfNXO2NX00Nx01JNx0QxO5val uexrNx80Nx10 java. Lang. Number\x86\xac\x95\x1d\x@b\ 
x94\xe@\x8b\x82\x80\x00xp\x0@\x00\x00\x20\x20\x80\x80\x81t\x80\tdalaoyangt\x00\x 
03123" 

127.0.0.1:6379» 


图 5-3 redis-cli 查看 图 三 


从 图 5-3 中 可 以 看 出 ，value 的 编码 似乎 也 有 一 些 问题 。 我 们 继续 改造 set 方法 ， 使 用 
Jackson2JsonRedisSerializer 对 User 类 数据 进行 实例 化 编码 ， 修 改 set 方法 后 如 代码 清单 5-11 所 示 。 


代码 清单 5-11 Spring Boot 使 用 Redis 项 目 修改 set 方法 后 的 代码 


public void set(String key, Object value) ( 
redisTemplate.setKeySerializer(new StringRedisSerializer()); 
redisTemplate.setValueSerializer (new 
Jackson2JsonRedisSerializer (Object.class)); 
ValueOperations«String,Object» vo = redisTemplate.opsForValue(); 
vo.set(key, value); 


) 


重新 启动 项 目 后 ， 再 次 插入 数据 ， 这 时 就 不 需要 对 Redis 进行 清空 了 ， 因 为 相同 key 的 数据 会 
覆盖 ， 如 图 5-4 所 示 。 


79> get 1 
"userName\":\"dalaoyang\" ,\"userPassword\" :\"123\"}" 


:6379> 
图 54 redis-cli 查看 图 四 
接 下 来 用 get 方法 对 刚刚 set 方法 存储 的 值 进行 取 值 ， 在 浏览 器 上 访问 http://localhost:8080/ 
getUserById?id=1， 可 以 看 到 浏览 器 显示 了 如 下 数据 : 
{"id":1,"userName":"dalaoyang", "userPassword":"123"] 


到 这 里 ，set 方法 已 经 测试 完毕 。 由 于 样 例 代 码 只 用 了 这 两 种 数据 结构 ， 因 此 只 对 这 两 种 结构 
进行 实例 化 。 其 实 还 提供 了 很 多 种 类 型 的 实例 化 模板 供 我 们 使 用 ， 有 具体 可 以 根据 需要 修改 。 


5.24 使 用 Redis 缓存 


在 刚刚 对 Redis 的 使 用 中 ， 只 是 使 用 Redis 作为 数据 库 。 接 下 来 我 们 利用 Redis 作为 缓存 数据 
库 进 而 分 担 数据 库 的 压力 。 其 实在 真实 的 开发 环境 中 , 一般 都 是 以 传统 数据 库 为 主 、 缓 存 数 据 库 为 
辅 ， 这 样 就 可 以 极 大 地 提高 数据 库 的 访问 性 能 。 

接 下 来 我 们 继续 改造 项 目 ， 其 实 大 致 原理 是 这 样 的 ， 首 先 向 数据 库 中 插入 一 条 数据 ， 然 后 查 
询 这 条 数据 ， 在 第 一 次 查询 的 时 候 从 数据 库 查询 ， 然 后 将 数据 存 入 Redis 并 设置 过 期 时 间 ， 其 间 ， 
再 次 查询 就 会 先 查 询 Redis， 如 果 在 Redis 内 没有 查 到 ， 重 复 这 个 流程 。 以 JPA 操作 数据 库 为 例 ， 
加 入 JPA 依赖 以 及 MySQL 依赖 、 配 置 文件 及 UserRepository， 引 用 5.2.3 节 的 内 容 即 可 。 依赖 内 容 
如 代码 清单 5-12 所 示 。 
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代码 清单 5 Spring Boot 使 用 Redis 项 目 引 入 JPA 依赖 和 MySQL 依赖 代码 


<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-data-jpa</artifactId> 
</dependency> 
<dependency> 
<groupId>mysql</groupId> 
<artifactId>mysql-connector-java</artifactId> 
Xscope»runtimec/scope» 


</dependency> 


接 下 来 ， 在 RedisService 内 新 增 一 个 可 以 设置 过 期 时 间 的 方法 ， 其 实 就 是 在 set 方法 中 新 增 两 
个 参数 : 过 期 时 间 和 过 期 时 间 单位 。 新 增 set 方法 如 代码 清单 5-13 所 示 。 


代码 清单 5-13 Spring Boot 使 用 Redis 项 目 RedisService 类 新 增 set 方法 代码 


public void set(String key, Object value , Long time, TimeUnit t) ( 
redisTemplate.setKeySerializer(new StringRedisSerializer()); 
redisTemplate.setValueSerializer (new 
Jackson2JsonRedisSerializer (Object.class)); 
ValueOperations«String,Object» vo = redisTemplate.opsForValue(); 
vo.set(key, value,time,t); 
$ 


接 下 来 ， 在 UserController 内 新 增 两 个 方法 : 一 个 是 插入 数据 库 数据 的 方法 ， 另 一 个 执行 先 查 
if] Redis， 青 查询 数据 库 的 逻辑 。 新 增 代码 片段 如 代码 清单 5-14 所 示 。 


单 5-14 Spring Boot 使 用 Redis 项 目 UserController 类 新 增 方法 代码 


@GetMapping ("/saveUser2") 
public User saveUser2(Long id, String userName, String userPassword)( 
User user - new User(id,userName, userPassword); 
userRepository.save (user); 
return user; 


GGetMapping(value - "getUser") 
public Object getUser(Long id)( 
Object object -redisService.get(id.toString()); 
if(object == null)( 
object = (userRepository.findById(id)).get(); 
if(object != null)( 
redisService.set (id.toString(),object,100L,TimeUnit.SECONDS); 
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return object; 
ji 


重启 项 目 ， 先 在 浏览 器 上 访问 http:Wlocalhost:8080/getUser?id=1， 对 数据 库 插入 一 条 数据 ， 再 
访问 http://localhost:8080/getUser?id=1， 可 以 看 到 控制 台 输出 如 下 : 


Hibernate: select user0 .id as idl 0 0 , user0_ .user name as user nam? 0 O0 , 
user0 .user password as user pas3 0 0 from user user0 where user0 .id-? 


再 次 访问 http://localhost:8080/getUser?id=1， 发 现 控制 台 没有 输出 ， 因 为 这 次 是 从 Redis 内 读 
取 数 据 的 ，100 秒 后 ， 还 需要 从 数据 库 查 询 一 次 。 到 这 里 ， 使 用 Redis 缓存 就 完成 了 。 还 有 很 多 可 
以 拓展 的 内 容 ， 感 兴趣 的 读者 可 以 继续 钻研 。 


5.3 使 用 Memcached 


5.3.1 Memcached 简介 


Memcached 是 一 个 自由 开源 的 、 高 性 能 的 、 分 布 式 的 内 存 对 象 缓存 系统 。Memcached 是 以 
LiveJournal 旗下 Danga Interactive 公司 的 Brad Fitzpatric 为 首开 发 的 一 款 软件 。 现 在 已 成 为 Mixi、 
Hatena、Facebook、Vox、LiveJournal 等 众多 服务 中 提高 Web 应 用 扩展 性 的 重要 因素 。Memcached 
是 一 种 基于 内 存 的 key-value 存储 ， 用 来 存储 小 块 的 任意 数据 〈 字 符 串 、 对 象 ) 。 这 些 数据 可 以 是 
数据 库 调用 、API 调用 或 者 页 面 泻 染 的 结果 。 Memcached 简洁 而 强大 , 它 的 简洁 设计 便于 快速 开发 ， 
降低 了 开发 难度 ， 解 决 了 大 数据 量 缓存 的 很 多 问题 。 它 的 API 兼容 大 部 分 流行 的 开发 语言 。 本 质 
上 ，Memcached 是 一 个 简洁 的 key-value 存储 系统 。 一 般 的 使 用 目的 是 通过 缓存 数据 库 查 询 结果 ， 
减少 数据 库 访问 次 数 ， 以 提高 动态 Web 应 用 的 速度 和 可 扩展 性 。 


5.3.2 配置 Memcached 依赖 


新 建 项 目 ， 在 项 目 中 加 入 Memcached 依赖 ，pom 文件 依赖 代码 如 代码 清单 5-15 所 示 。 


代码 清单 5-15 Spring Boot 项 目 使 用 Memcached mA Memcached 依赖 代码 


<dependency> 
<groupId>net .spy</groupId> 
<artifactId>spymemcached</artifactId> 
<version>2.12.2</version> 
</dependency> 


然后 在 配置 文件 配置 Memcached 信息 ,主要 包含 Memcached 服务 器 地 址 和 端口 ， 如 代码 清单 
5-16 所 示 。 


第 5 章 Spring Boot 的 缓存 之 旅 | 133 


代码 清单 5-16 Spring Boot 项 目 使 用 Memcached 项 目 配置 文件 代码 


memcache.ip-localhost 
memcache.port-11211 


使 用 Memcached 还 需要 与 Memcached 数据 库 建 立 连接 来 对 数据 库 进 行 操作 。 接 下 来 我 们 配置 
一 个 MemcachedConfig, 并 且 在 配置 类 中 封装 一 些 Memcached 常用 的 方法 , 如 代码 清单 5-17 所 示 。 


@Component 
public class MemcachedConfig implements CommandLineRunner { 
private Logger logger = LoggerFactory.getLogger (this.getClass()); 


GValue("$(memcache.ip)") 
private String memcacheIp; 


@Value ("$(memcache.port])") 
private Integer memcachePort; 


private MemcachedClient client - null; 


GOverride 
public void run(String... args) throws Exception ( 
try ( 
client - new MemcachedClient (new InetSocketAddress (memcacheIp, 
memcachePort)); 
) catch (IOException e) ( 
logger.error("Connection to server failed",e); 
} 
logger.info("Connection to server success"); 


) 


public MemcachedClient getClient() ( 
return client; 


public Boolean set(String key,int time,String value) ( 
Boolean b - false; 
tryt 
b-(this.getClient().set(key, time, value)).get(); 
)catch (Exception e)í( 
logger.error (e.getMessage()); 
l 


return b; 
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public Boolean add(String key,int time,String value){ 
Boolean b - false; 
try( 
b-(this.getClient().add(key, time, value)).get(); 
]catch (Exception e){ 
logger.error(e.getMessage()); 
) 
return b; 


i] 


public Object replace (String key,int time,String value){ 
Boolean b = false; 


try{ 
b-(this.getClient().replace(key, time, value)).get(); 
)catch (Exception e)( 
logger.error(e.getMessage()); 
} 
return b; 


} 


public Object append (String key,int time,String value) { 
Boolean b = false; 
tryt 
b-(this.getClient().append(key, value)).get(); 
)catch (Exception e)í 
logger.error(e.getMessage()); 
h 
return b; 


$ 


public Object Prepend (String key,int time,String value) { 
Boolean b = false; 
try{ 
b-(this.getClient().prepend(key, value)).get(); 
Jcatch (Exception e)( 
logger.error(e.getMessage()); 
H 


return b; 


public Object cas(String key,int time,String value)í 
return this.getClient().cas(key, time, value); 
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) 


public Object get(String key)( 
return this.getClient().get(key); 
H 


public Boolean delete (String key)í 

Boolean b - false; 

tryí 
b-(this.getClient().delete(key)).get(); 

)catch (Exception e)( 
logger.error(e.getMessage()); 

$ 

return b; 


i 


public long incr (String key,Integer value)( 
return this.getClient().incr(key,value); 


) 


public long decr(String key,Integer value)( 
return this.getClient().decr(key,value); 
) 


基于 对 Memcached 的 常用 操作 大 致 分 为 如 下 几 种 。 


set 方法 : 当前 方法 用 于 将 value (数据 值 ) 存储 在 指定 的 key ( 键 ) 中 ， 并 可 以 设置 对 应 的 过 
期 时 间 。 如 果 当 前 key 存在 值 , 就 更 新 value; 如 果 不 存 在 或 已 经 过 期 , 就 存储 对 应 的 数据 值 。 
add Zik: 当前 方法 用 于 将 value (数据 值 ) 存储 在 指定 的 key ( 键 ) 中 。 如 果 add 的 key 已 
经 存在 ， 就 不 会 更 新 数据 ( 过 期 的 key 会 更 新 ) 之 前 的 值 将 仍然 保持 相同 ， 并 且 你 将 获得 响 
应 NOT_STORED. 

replace 方法 : 当前 方法 用 于 替换 已 存在 的 key (bb) 的 value (数据 值 ) 如 果 key 不 存在 ， 
替换 就 会 失败 ， 并 且 你 将 获得 响应 NOT STORED, 

append Zik: 当前 方法 用 于 向 已 存在 key ( 键 ) 的 value (数据 值 ) 后 面 追 加 数据 。 

prepend 方法 : 当前 方法 用 于 向 已 存在 key ( 键 ) 的 value (数据 值 ) 前 面 追加 数据 。 

cas 方法 : 当前 方法 用 于 执行 一 个 “检查 并 设置 ”的 操作 ， 它 仅 在 当前 客户 端 最 后 一 次 取 值 
后 ,该 key 对 应 的 值 没有 被 其 他 客户 端 修改 的 情况 下 , 才能 够 将 值 写 入 。 检 查 是 通过 cas token 
参数 进行 的 ， 这 个 参数 是 Memcached 指定 给 已 经 存在 的 元 素 的 唯一 的 64 位 值 。 

get 方法 : 当前 方法 用 于 获取 存储 在 key ( 键 ) 中 的 value (数据 值 )， 如 果 key 不 存在 或 者 已 
经 过 期 ， 就 返回 空 。 

gets 方法 : 当前 方法 用 于 获取 带 有 CAS 令 牌 存储 的 value (数据 值 ) 如 果 key 不 存在 ， 就 返 
回 空 。 


delete 方法 : 当前 方法 用 于 删除 已 存在 的 key ( 键 )。 
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* incr 方法 : 当前 方法 用 于 对 已 存在 的 key (4E) 的 数字 值 进 行 自 增 操 作 。 如 果 key 不 存在 ， 就 
返回 NOT FOUND; 如果 键 的 值 不 为 数字 , 就 返回 CLIENT ERROR; 其 他 错误 返回 ERROR, 
* decr 方法 : 当前 方法 用 于 对 已 存在 的 key ( 键 ) 的 数字 值 进行 自 减 操作 。 如 果 key 不 存在 ， 
就 返回 NOT FOUND; 如 果 键 的 值 不 为 数字 ， 就 返回 CLIENT ERROR; 其 他 错误 返回 
ERROR, 
方法 指令 很 多 ， 大 多 数 都 很 好 理解 ， 都 是 一 些 对 数据 库 的 常用 操作 。 这 里 以 新 增 用 户 、 查 询 
用 户 、 删 除 用 户 的 流程 进行 测试 ， 实 体 类 还 是 之 前 的 User 实体 类 ， 实 体 类 记得 要 重 写 toString() 方 
法 ， 接 下 来 会 用 到 。 新 建 一 个 UserController 类 ， 在 其 中 加 入 新 增 查 询 和 删除 的 方法 ， 如 代码 清单 
5-18 所 示 。 


代码 清单 5-18 Spring Boot 项 目 使 用 Memcached 项 目 UserController 类 代码 


GRestController 
public class UserController ( 


GResource 
private MemcachedConfig memcachedConfig; 


GGetMapping(value = "saveUser") 

public Boolean saveUser(Long id, String userName, String userPassword)( 
User user = new User(id, userName, userPassword); 
return memcachedConfig.set(id.toString(), 1000,user.toString()); 


GGetMapping(value = "getUserById") 
public Object getUserById(Long id) ( 
return memcachedConfig.get (id.toString()); 


@GetMapping (value = "deleteUserCacheById") 
public Boolean deleteUserCacheById(Long id) ( 
return memcachedConfig.delete (id.toString()); 


) 


启动 项 目 ， 在 浏览 器 上 访问 http;//localhost:8080/saveUser?id-1 &userName-dalaoyang& 
userPassword=123&time=10， 可 以 看 到 显示 如 下 : 


true 


接 下 来 , 我 们 在 浏览 器 上 访问 localhost:8080/getUserById?id=1, 这 个 方法 的 显示 结果 就 是 User 
实体 类 的 toString() 方 法 的 结果 ， 显 示 如 下 : 


User(id-1, userName-'dalaoyang', userPassword-'123'] 
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最 后 ， 我 们 在 浏览 器 上 访问 http:Wlocalhost:8080/deleteCacheById?id=1， 删 除数 据 ， 然 后 调用 
查询 方法 ， 发 现 返 回 结果 为 空 。3 个 方法 到 这 里 都 测试 完了 ， 感 兴趣 的 读者 可 以 自己 将 所 有 方法 都 
测试 一 遍 ， 以 便于 具体 使 用 。 


5.3.3 ”使 用 Memcached 缓存 


使 用 Memcached 作为 数据 库 缓 存 的 流程 其 实 和 使 用 Redis 缓存 一 致 ,也 是 首先 查询 Memcached 
是 否 含有 数据 ， 如 果 数 据 不 存在 或 已 经 过 期 ， 就 先 从 数据 库 查询 ， 再 插入 Memcached 数据 以 提供 
下 次 使 用 。 

配置 文件 与 依赖 文件 这 里 就 不 再 展示 了 。 添 加 一 个 查询 方法 ， 以 供 使 用 Memcached 缓存 ， 如 
代码 清单 5-19 所 示 。 


代码 清单 5-19 Spring Boot 项目 使 用 Memcached 项 目 UserController 类 方法 代码 


GAutowired 


private UserRepository userRepository; 


GGetMapping ("/saveUser2") 

public User saveUser2(Long id, String userName, String userPassword) ( 
User user - new User(id, userName, userPassword); 
userRepository.save (user); 
return user; 


) 


GGetMapping(value = "getUserById2") 
public Object getUserById2 (Long id) ( 
Object object = memcachedConfig.get (id.toString()); 
if (object == null) ( 
object = (userRepository.findById(id)).get(); 
if (object !- null) ( 
memcachedConfig.set(id.toString(), 1000, object.toString()); 
} 
i 
return object; 
} 


重启 项 目 ， 先 访问 http:/localhost:8080/saveUser2?id=1 &userName=dalaoyang&userPassword= 
123&time=10， 向 数据 库 中 插入 一 条 数据 ， 再 访问 http://localhost:8080/getUserById2?id=1， 第 一 次 
控制 台 打 印 了 SQL， 因 为 缓存 没有 数据 ， 第 二 次 控制 台 没 有 打印 SQL， 因 为 这 次 查询 的 是 
Memcached 。 
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5.3.4 Redis 与 Memcached 的 区 别 

对 于 缓存 层 ， 使 用 Memcached 和 Redis 都 可 以 完美 解决 ， 这 里 大 致 列 出 笔者 总 结 的 二 者 的 
区 别 。 

1. 数据 类 型 支持 不 同 


Memcached 只 支持 简单 的 key-value 存储 ， 而 Redis 除了 支持 key-value 外 ， 还 支持 list、set、 
hash, zset 结构 。 


2. 数据 一 致 性 

Memcached 内 部 提供 了 cas 命令 ,可 以 保证 在 高 并 发 下 访问 数据 的 一 致 性 问题 , 而 Redis 没有 
提供 类 似 cas 的 命令 ,但 是 Redis 提供 了 事务 的 功能 ， 可 以 用 其 保证 事务 的 原子 性 。 

3. value 值 大 小 

Redis 的 value 值 最 大 可 达 1GB， 而 Memcached 只 有 1MB。 

4. 存储 方式 


Memcached 将 数据 全 部 存储 在 内 存 中 , 当 发 生 断 电 或 者 内 存 分 配 不 足 时 会 造成 数据 丢失 。Redis 
支持 数据 的 持久 化 ， 可 以 将 内 存 中 的 数据 保持 在 磁盘 中 ， 重 启 的 时 候 可 以 再 次 加 载 使 用 。 


5. 网 络 IO 模型 

Redis 使 用 单线 程 的 IO 复 用 模型 ，Memcached 是 多 线程 ， 非 阻塞 IO 复 用 的 网 络 模型 。 
6. 持久 化 支持 

Redis 提供 了 RDB 和 AOF 的 持久 化 支持 ，Memcached 不 支持 持久 化 。 

7. 应 用 场景 


Memcached 多 用 于 缓存 数据 集 、 临 时 数据 、Session 等 ， 而 Redis 除了 可 以 用 作 缓存 数 据 库 外 ， 
还 可 以 用 作 消 息 队 列 、 数 据 堆栈 等 。 
以 上 是 笔者 总 结 的 几 点 区 别 ， 至 于 具体 场景 应 该 使 用 哪 种 ， 还 需要 具体 分 析 。 


5.4 小 Za 


本 章 实 质 上 是 对 第 4 章 Spring Boot 使 用 数据 库 的 扩展 ， 利 用 缓存 来 减轻 数据 库 的 压力 ， 进 一 
步 对 Spring Boot 的 使 用 进行 学 习 。 


Spring Boot 的 日 志 之 旅 


日 志 是 追溯 系统 使 用 、 问 题 跟踪 的 依据 ， 是 一 个 系统 不 可 缺少 的 重要 组 成 部 分 。 在 开发 阶段 ， 
我 们 可 能 比较 容易 对 系统 进行 监控 ， 但 是 对 于 分 布 式 系统 ， 日 志 收 集 对 于 开发 者 维护 系统 、Bug 
定位 起 着 至 关 重 要 的 作用 。 本 章 将 对 Spring Boot 的 一 些 常用 日 志 进行 分 析 和 学 习 。 

Spring Boot 使 用 Commons Logging 进行 所 有 内 部 日 志 记录 , 但 保留 底层 日 志 实 现 。 为 Java Util 
Logging. Log4j2 和 Logback 提供 了 默认 配置 。 每 种 情况 下 ， 记 录 器 都 预先 配置 为 使 用 控制 台 输 出 ， 
并 且 提 供 可 选 的 文件 输出 。 

默认 情况 下 ， 如 果 使 用 Starters， 就 使 用 Logback 进行 日 志 记 录 。 还 包括 适当 的 Logback 路 由 ， 
以 确保 使 用 Java Util Logging. Commons Logging. Log4j 或 SLF4J 的 依赖 库 都 能 正常 工作 。 


6.1 Logback 日 志 


在 Spring Boot 框架 中 , 默认 使 用 的 是 Logback 日 志 。 接 下 来 我 们 看 一 下 Spring Boot 是 如 何 使 
用 日 志 的 。 


6.1.1 Logback 简介 


Logback 日 志 框 架 (官网 地 址 : https://logback.qos.ch/) 是 由 Log4j 创始 人 开发 的 另 一 套 开源 日 
志 组 件 。Logback 的 体系 非常 强大 ， 提 供 了 3 个 模块 供 开发 者 使 用 。 
* logback-core: 属于 Logback 的 基础 模块 ， 是 其 他 两 个 模块 的 基础 。 
* logback-classic: 可 以 看 作 Log4j 的 改进 版 本 ， 同 时 logback-classic 自身 实现 了 SLF4J API, 使 开发 
者 可 以 在 Logback 框架 与 其 他 日 志 框架 (Jr Log4j 或 javautiLlogging ) 之 间 自 由 切换 。 
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logback-access: 5 Servlet 容器 (如 Tomcat 和 Jetty) 集成 ， 以 提供 HTTP 访问 日 志 功 能 。 


当然 ，Logback 支持 开发 者 基于 logback-core 模块 构建 自 定义 模块 。 


6.1.2 ”日志 格式 


Spring Boot 项 目 启动 后 ， 默 认可 以 看 到 如 图 6-1 所 示 的 界面 。 


6-1 Logback 项 目 启动 日 志 


从 图 6-1 中 可 以 看 到 ，Spring 的 Logo 部 分 是 Spring Boot 框架 自 带 的 ， 我 们 只 观察 日 志 部 分 。 
日 志 大 致 分 为 如 下 格式 。 


. 
e. 
. 
. 
. 
. 
. 


6.1.3 


时 间 日 期 : 显示 日 志 打印 时 间 ， 精 确 到 毫秒 。 

日 志 级 别 : 日 志 级 别 分 为 FATAL、ERROR、WARN、INFO、DEBUG、TRACE. 
进程 ID: 进程 ID 指 的 是 当前 应 用 对 应 的 PID。 

分 隔 符 : 分 隔 符 用 于 区 分 实际 日 志 消息 的 开始 。 

线程 名 称 : 括 在 方 括号 中 (可 能 会 截断 控制 台 输 出 )。 

记录 器 名 称 : 一 般 使 用 类 名 。 

日 志 内 容 : 日 志 输 出 的 具体 内 容 。 


控制 台 输出 


在 Spring Boot 默认 应 用 日 志 配 置 中 ， 会 将 日 志 默 认输 出 到 控制 台中 。 在 默认 情况 下 ， 只 会 i 
录 ERROR-level、WARN-level 和 INFO-level 级 别 的 日 志 消息 。 当 然 ， 也 可 以 指定 日 志 级 别 进行 日 
志 输 出 ， 如 果 指 定 了 日 志 级 别 ， 那 么 只 会 对 应 输出 高 于 指定 级 别 的 日 志 信息 。 当 然 ，Spring Boot 
默认 为 我 们 提供 了 调试 模式 〈 建 议 在 开发 过 程 中 开启 ) ， 启 动 调 试 模式 有 如 下 两 种 方式 。 


启动 JAR 模式 : 在 启动 JAR 的 时 候 通过 使 用 --debug 标志 启动 应 用 程序 调试 模式 ， 如 代码 清 
单 6-1 所 示 。 


代码 清单 6-1 Logback 项 目 jar 方式 启动 应 用 


java -jar myapp.jar --debug 
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e 在 配置 文件 中 的 配置 : 在 application.properties 或 者 application.yml 中 配置 属性 debug-true. 


同时 , 默认 日 志 提供 彩色 日 志 输出 , 如 果 终 端 支持 ANSI, 那么 在 默认 设置 下 , TRACE, DEBUG 
和 INFO 级 别 为 绿色 ，WARN 级 别 为 黄色 ，ERROR fl FATAL 级 别 为 红色 。 


6.1.4 ”日志 文件 输出 


默认 情况 下 ，Spring Boot 只 会 将 日 志 消 息 打 印 到 控制 台 ， 并 不 会 将 日 志 写 入 日 志文 件 。 但 是 
在 实际 项 目 中 ， 一 定 会 需要 日 志文 件 来 分 析 程序 。 其 实在 Spring Boot 工程 中 ， 想 要 输出 控制 台 之 
外 的 日 志文 件 很 简单 , 只 需要 在 application.properties 文件 或 application.yml 文件 内 设置 logging.file 
或 logging.path 属性 即 可 。 
* loggingfile : 设置 日 志文 件 ， 这 里 可 以 设置 文件 的 绝对 路 径 ， 也 可 以 设置 文件 的 相对 路 径 ， 
具体 可 以 根据 情况 设置 ， 如 logging.file-test.log. 
* loggingpath : 设置 日 志 目 录 ， 在 设置 好 目录 后 ,会 在 设置 目录 文件 夹 下 创建 一 个 spring.log， 
如 设置 logging.path-/Users/dalaoyang. 


上 述 两 个 属性 中 ， 如 果 只 设置 一 个 ， 那么 Spring Boot 应 用 会 默认 读 取 该 配置 , 如 果 同 时 设置 ， 
那么 只 有 logging.file 会 生效 。 

Spring Boot 应 用 日 志文 件 输出 与 控制 台 输 入 内 容 一 致 ， 在 日 志文 件 达到 10MB 的 时 候 会 自动 
分 隔日 志文 件 ， 默 认 情 况 下 会 记录 ERROR-level、WARN-level 和 INFO-level 消息 。 当 然 ， 日 志文 
件 可 以 通过 设置 logging.file.max-size 属性 更 改 大 小 限制 ， 并 非 无 法 更 改 。 


6.1.5 日 志 级 别 


所 有 受 支 持 的 日 志 记 录 系 统 都 可 以 通过 使 用 TRACE、DEBUG、INFO、WARN、ERROR、FATAL 
或 OFF 之 一 来 在 Spring 中 设置 记录 器 级 别 ， 如 下 面 几 种 格式 。 

* logging.level.root - WARN: root 日 志 以 WARN 级 别 输出 消息 。 

* logging.level.com.dalaoyang = DEBUG: com.dalaoyang 包 下 的 类 以 DEBUG 级 别 输 出 。 


另外 ， 也 可 以 设置 日 志 组 来 批量 设置 日 志 级 别 ， 比 如 设 定 com.dalaoyang.controller 和 
com.dalaoyang.service 为 同一 组 〈 包 与 包 之 间 用 英文 格式 的 逗号 分 隔 ) ， 如 代码 清单 6-2 所 示 。 


代码 清单 6-2 Logback 项 目 配置 日 志 组 


logging.group.dalaoyang -com.dalaoyang.controller,com.dalaoyang.service 


然后 ， 设 置 dalaoyang 组 日 志 级 别 为 TRACE， 如 代码 清单 6-3 所 示 。 


代码 清单 6-3 Logback 项 目 配置 日 志 组 日 志 级 别 


logging.level.dalaoyang = TRACE 
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Spring Boot 默认 提供 两 个 日 志 组 ， 如 代码 清单 6-4 所 示 。 


代码 清单 6-4 Logback 项 目 配置 日 志 组 日 志 级 别 


logging.group.web -org.springframework.core.codec, 
org.springframework.http, org.springframework.web 
logging.group.sql -org.springframework.jdbc.core, org.hibernate.SQL 


6.1.6 日 志 配 置 


除了 上 面 介绍 的 配置 属性 外 ， 其 实 还 有 很 多 属性 供 我 们 使 用 ， 例 如 : 


logging.exception-conversion-word: 记录 异常 时 使 用 的 转换 字 。 
loggingfile: 设置 日 志文 件 。 

logging.file.max-size: 最 大 日 志文 件 大 小 。 
logging.config: 日 志 配置 。 

logging.file.max-history: 最 大 归档 文件 数量 。 
loggingpath: 日 志文 件 目录 。 
logging.pattern.console: 在 控制 台 输 出 的 日 志 模式 。 
logging.pattern.dateformat: 日 志 格 式 内 的 日 期 格式 。 
logging.pattern.file: 默认 使 用 日 志 模 式 。 
logging.pattern.level: 日 志 级 别 。 

PID: 当前 进程 ID。 


61.7 基于 XML 配置 日 志 


Spring Boot 默认 支持 通过 XML 配置 自 定义 日 志 格 式 及 输出 ， 并 且 在 ApplicationContext 创建 
前 就 已 经 进行 了 初始 化 。 在 Spring Boot 默认 使 用 的 Logback 中 ， 可 以 通过 在 sre/mian/resources X 
件 夹 下 定义 logback.xml 或 logback-spring.xml 作为 日 志 配 置 。 

不 过 Spring Boot 官方 推荐 优先 使 用 带 有 -spring 的 文件 名 作为 你 的 日 志 配置 《如 使 用 
logback-spring.xml， 而 不 是 logback.xml) ， 因 为 如 果 命名 为 logback-spring.xml 日 志 配置 ， 就 可 以 
在 日 志 输 出 的 时 候 引 入 一 些 Spring Boot 特有 的 配置 项 。 当 然 ， 也 支持 自 定义 日 志 配置 ， 比 如 在 
application.properties 或 application.yml 中 配置 logging.config=classpath:logback- config.xml， 就 会 读 
取 logback-config.xml 配置 对 日 志 进 行 输 出 。 


1. 控制 台 输 出 日 志 


接 下 来 ， 我 们 改造 一 下 日 志文 件 格式 。 首 先 在 src/mian/resources 目录 下 创建 一 个 
logback-spring.xml， 这 里 以 输出 到 控制 台 为 例 ， 可 以 在 配置 文件 中 设置 如 下 内 容 ， 如 代码 清单 6-5 
所 示 。 
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代码 清单 6-5 Logback MA xml- 输 出 到 控制 台 


<configuration> 

<appender name-"STDOUT" class-"ch.qos.logback.core.ConsoleAppender"» 
«encoder» 
Xpattern»$date $-51level [$thread] $1ogger(80) - $msg$n«/pattern» 
Xcharset?»UTF-8«/charset» 
«/encoder» 

«/appender» 


«root level-"debug"» 
X«appender-ref ref-"STDOUT" /> 

«/root» 

X/configuration» 


在 上 述 pattern 标签 中 的 内 容 都 对 应 日 志 相关 的 信息 ， 分 别 如 下 。 


* %date: 日 志 输 出 时 间 ， 也 可 以 使 用 %d 来 表示 ， 同 时 可 以 用 {yyyy-MM-dd HH:mm:ss.SSS] 4f 
形式 对 日 志 的 输出 时 间 进 行 格式 化 。 

%thread: 输出 日 志 的 进程 名 字 。 

%-5level: 日 志 级 别 ， 并 且 使 用 5 个 字符 靠 左 对 齐 ， 也 可 以 使 用 %p 输出 日 志 级 别 。 
%logger{80}: 日 志 输 出 者 的 名 字 。 

%msg: 日 志 消息 。 

An: 平台 的 换行 符 。 

%c: 用 来 在 日 志 上 输出 类 的 全 名 。 


这 里 需要 注意 ， 将 编码 格式 设置 为 UTF-8， 避 免 中 文 乱码 。 
在 root 标签 内 设置 日 志 级 别 ， 效 果 等 同 于 在 配置 文件 中 设置 logging.pattern.level。 
2. 彩色 日 志 输出 


启动 项 目 后 ， 可 以 看 到 日 志 有 对 应 输出 ， 但 是 日 志 并 没有 颜色 。 接 下 来 我 们 修改 一 下 配置 文 
件 ， 如 代码 清单 6-6 所 示 。 


代码 清单 6-6 Logback 项 目 xml- 彩 色 日 志 配置 


<configuration> 
<conversionRule conversionWord-"clr" converterClass- 
"org.springframework.boot.logging.logback.ColorConverter" /» 
XconversionRule conversionWord-"wex" converterClass-"org. 
springframework.boot.logging.logback.WhitespaceThrowableProxyConverter" /> 
XconversionRule conversionWord-"wEx" converterClass-"org. 
springframework.boot.logging.logback. 


ExtendedWhitespaceThrowableProxyConverter" /» 
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Xproperty name-"CONSOLE LOG PATTERN" value-"$(CONSOLE LOG PATTERN: 
-*$clr($d(yyyy-MM-dd HH:mm:ss.SSS))(faint) $clr($(LOG LEVEL PATTERN:-$5p]) 
S$clr(S(PID:- )) (magenta) $clr(---)(faint) $clr([$15.15t]) (faint) 
$clr($-40.4010gger(39)) (cyan) $clr(:)(faint) 
$m$n$(LOG EXCEPTION CONVERSION WORD:-$wEx])"/» 


«appender name-"STDOUT" class-"ch.qos.logback.core.ConsoleAppender"» 
«encoder» 
Xpattern»$(CONSOLE LOG PATTERN)«/pattern» 
Xcharset»UTF-8«/charset» 
«/encoder» 
«/appender» 


«root level-"debug"» 
Xappender-ref ref-"STDOUT" /> 
«/root» 


X/configuration» 


在 这 里 需要 配置 几 个 Logback 提供 的 彩色 日 志 类 ， 并 使 用 这 些 对 日 志 进 行 修饰 。 这 次 配置 有 
一 个 不 同 点 是 ，Logback 配置 文件 可 以 使 用 property 标签 自 定义 属 性 ， 然 后 在 下 面 使 用 $ {property 
属性 name 值 }。 在 完成 上 述 配 置 后 ， 再 次 启动 日 志 就 可 以 看 到 彩色 日 志 了 。 

3. 日 志文 件 输出 


控制 台 输出 日 志 的 形式 一 般 只 有 开发 环境 这 样 使 用 ， 一 般 来 说 ， 生 产 环境 需要 将 日 志 输出 到 
日 志文 件 进行 日 志 分 析 , 并 且 会 将 日 志 根据 级 别 输出 到 不 同日 志文 件 中 。 同时 , 如 果 日 志文 件 太 大 ， 
就 可 以 设置 日 志文 件 根据 大 小 分 隔 ， 如 代码 清单 6-7 所 示 。 


代码 清单 6-7 Logback 项 目 xml- 输 出 到 日 志文 件 


«configuration» 


Xproperty name-"log.path" value-"/Users/dalaoyang/logs/testLog" /» 


X«appender name-"DEBUG FILE" class= 
"ch.qos.logback.core.rolling.RollingFileAppender"» 
«file»$(log.path]/log debug.log«/file» 
«encoder» 
Xpattern»$d(yyyy-MM-dd HH:mm:ss.SSS) [$thread] $-51level 
$1ogger(50) - $msg$n«/pattern» 
«charset»UTF-8«/charset» 
«/encoder» 
«rollingPolicy class-"ch.qos.logback.core.rolling. 
TimeBasedRollingPolicy"» 
«fileNamePattern»$(1log.path)/debug/log-debug-$d(yyyy-MM-dd]. 
Si.log«/fileNamePattern» 
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<timeBasedFileNamingAndTriggeringPolicy 
class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP"> 
<maxFileSize>50MB</maxFileSize> 

</timeBasedFileNamingAndTriggeringPolicy> 
<maxHistory>30</maxHistory> 

</rollingPolicy> 

«filter class="ch.qos.logback.classic.filter.LevelFilter"> 
<level>debug</level> 
<onMatch>ACCEPT</onMatch> 
<onMismatch>DENY</onMismatch> 

</filter> 

</appender> 


<root level="debug"> 
<appender-ref ref="DEBUG FILE" /> 
</root> 


</configuration> 


在 上 述 配 置 中 包含 很 多 新 标签 ， 分 别 说 明 如 下 。 

file: 日 志文 件 位 置 。 

maxFileSize: 设置 最 大 日 志文 件 大 小 。 

maxHistory: 只 保留 最 近 30 天 的 日 志 ， 防 止 日 志 过 多 占用 磁盘 。 
fileNamePattern: 指定 精确 到 分 的 日 志 切 分 方式 。 

filter: 标签 中 的 level 设置 日 志 级 别 。 


4. 输出 指定 包 文件 日 志 


Logback 可 以 指定 输出 某 个 包 下 的 类 的 日 志 , 这 种 方式 比较 简单 ， 只 需要 指定 包 路 径 及 日 志 级 
别 即 可 ， 如 代码 清单 6-8 所 示 。 


代码 清单 6-8 ”Logback WA xml- 输 出 到 日 志文 件 


<logger name-"com.dalaoyang" level-"DEBUG"» 
Xappender-ref ref-"DEBUG FILE" /> 
«/logger» 


Spring Boot 使 用 Logback 日 志 大 致 就 这 几 种 形式 。 当 然 ， 可 以 根据 具体 项 目 更 加 细 化 地 配置 
日 志文 件 ， 这 里 不 再 更 多 地 描述 了 ， 毕 竟 实 际 业 务 场 景 不 同 ， 配 置 的 方法 也 不 同 。 


6.2 Log4j 日 志 


Log4j 是 笔者 第 一 个 接触 的 日 志 框架 ， 截 至 目前 还 有 很 多 工程 使 用 这 个 日 志 框架 。 接 下 来 我 们 
学 习 一 下 Spring Boot 如 何 使 用 Log4j 日 志 。 
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6.2.1 Log4j 简介 


Log4j 日 志 ( 官 网 地 址 : http:/logging.apache.org/log4j/1.2/) 是 一 个 使 用 Java 编写 的 日 志 框架 ， 
由 Apache Software Foundation 的 一 个 专门 的 Committers 团队 开发 。 

Log4j 虽然 是 一 个 使 用 Java 开发 的 框架 , 但 是 它 同 样 支持 很 多 编程 语言 使 用 , 如 C CH, Net, 
PL/SQL. 


6.2.2 Spring Boot 使 用 Log4j 


虽然 现在 已 经 不 推荐 使 用 Log4j 了 ， 但 是 这 里 还 是 简单 介绍 一 下 Spring Boot 如 何 使 用 Log4j 
框架 。 在 6.1 节 我 们 了 解 到 Spring Boot 默认 引用 Logback 上 日志， 这 里 需要 在 pom 文件 中 移 除 
spring-boot-starter-logging 依赖 ， 并 加 入 Log4j 依赖 ， 如 代码 清单 6-9 所 示 。 


代码 清单 6-9 Log4j 项 目 -pom 文件 配置 


<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter</artifactId> 
<exclusions> 
<exclusion> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-logging</artifactId> 
</exclusion> 
</exclusions> 
</dependency> 


<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-log4j</artifactId> 
<version>1.3.2.RELEASE</version> 
«type»pom«/type» 

</dependency> 


6.2.3 ”控制 台 输 出 


在 使 用 Log4j 的 时 候 ， 默 认 会 读 取 src/main/resources 下 的 log4j.properties 文件 。 其 实 道理 和 配 
置 Logback 类 似 ， 先 进行 输出 到 控制 台 的 配置 ， 如 代码 清单 6-10 所 示 。 


代码 清单 6-10 ”Log4j 项 目 -pom 文件 配置 


log4j.rootLogger-debug, CONSOLE 
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## 输 出 到 控制 台 

log4j.appender.CONSOLE-org.apache.10g4j.ConsoleAppender 

log4j.appender.CONSOLE.Threshold-DEBUG 

log4j.appender.CONSOLE.layout.ConversionPattern-$d(yyyy-MM-dd HH\:mm\:ss} 
-$-4r [$t] $-5p $x - $m$n 

log4j.appender.CONSOLE.Target-System.out 

log4j.appender.CONSOLE.Encoding-UTF-8 

log4j.appender.CONSOLE.layout-org.apache.log4j.PatternLayout 


上 述 配 置 大 致 包含 如 下 内 容 。 

log4j.appenderCONSOLE: 控制 台 日 志 输 出 类 。 
log4j.appenderCONSOLE.Threshold: 日 志 级 别 。 
log4j.appender.CONSOLE.layout.ConversionPattern: 日 志 输出 信息 格式 。 
log4j.appender.CONSOLE.Target: 使 用 System.error 作为 输出 。 
log4j.appender.CONSOLE.Encoding: 日 志 编 码 格式 。 
log4j.appender.CONSOLE.layout: 设置 输出 样式 。 


在 日 志 输出 格式 中 可 以 使 用 如 下 自 定义 样式 进行 配置 。 
e c: 输出 所 属 的 类 目 ， 通 常 就 是 所 在 类 的 全 名 。 
%C: 输出 Logger 所 在 类 的 名 称 ， 通 常 就 是 所 在 类 的 全 名 。 


e %d: 输出 日 志 时 间 点 的 日 期 或 时 间 ， 默 认 格式 为 ISO8601， 与 Logback 一 致 ， 可 以 格式 化 日 
期 格式 ， 比 如 %dfyyy MMM dd HH:mm:ss}。 

e %F: 输出 所 在 类 的 类 名 称 ， 只 有 类 名 。 

e wd: 输出 语句 所 在 的 行 数 ， 包 括 类 名 、 方 法 名 、 文 件 名 、 行 数 。 

e AL: 输出 语句 所 在 的 行 数 。 

* om: 输出 代码 中 指定 的 信息 ， 如 log(message) 中 的 message. 

e M: 输出 方法 名 。 

e %p: 输出 日 志 级 别 ， 即 DEBUG, INFO, WARN, ERROR, FATAL, 

e Vo 输出 自 应 用 启动 到 输出 该 Log 信息 耗费 的 毫秒 数 。 

e Ot 输出 产生 该 日 志 事件 的 线程 名 。 

e %n: 输出 一 个 回 车 换行 符 ，Windows FEA “rm”, UNIX PEA “m”. 

e ww 用 来 输出 百 分 号 “%”。 


6.24 日 志文 件 输出 


如 果 需 要 使 用 日 志 输出 ， 就 需要 对 配置 文件 新 增 如 下 配置 ， 如 代码 清单 6-11 所 示 。 


代码 清单 6-11 Log4j 项 目 -Log4j 配置 文件 


log4j .rootLogger=debug,FILE 
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10g4j 
10g4j 
10g4j 
10g4j 
1og4j 
1og4j 


.appender. 
.appender. 
.appender. 
.appender. 
.appender. 
.appender. 


FILE-org.apache.log4j.DailyRollingFileAppender 
FILE.File-/Users/dalaoyang/Downloads/log 
FILE.DatePattern = ' 'yyyy-MM-dd-HH-mm'.log' 
FILE.MaxFileSize-10MB 
FILE.layout-org.apache.log4j.PatternLayout 
FILE.layout.ConversionPattern-$d$n$m$n 


上 述 配 置 大 致 包含 如 下 内 容 : 


log4j.appender.FILE: 日 志文 件 输出 类 。 

log4j.appender.FILE.File: 日 志文 件 输出 路 径 。 
log4j.appenderFILE.DatePattern: 日 志文 件 后 缓 格式。 
log4j.appenderFILE.MaxFileSize: 日 志文 件 输出 大 小 。 
log4j.appenderFILE.layout: 设置 输出 样式 。 
log4j.appender.FILE.layout.ConversionPattem: 日 志 输出 信息 格式 。 


到 这 里 ， 已 经 配置 完成 了 。 感 兴趣 的 读者 可 以 自己 配置 看 看 。Log4j 官网 上 已 经 不 推荐 使 用 


Log4j 框架 ， 而 推荐 使 用 拥有 更 好 性 能 的 Log4j 2 框架 ， 所 以 这 里 稍 作 了 解 即 可 。 


Apache Log4j 2〔 官 网 地 址 : https://logging.apache.org/log4j/2.x/index.html ) 是 对 Log4j 的 升级 ， 
它 对 前 身 Log4j Lx 进行 了 重大 改进 。6.2 节 我 们 对 Log4j 框架 有 了 一 定 的 了 解 ， 接 下 来 学 习 Spring 


6.3 Log4j 2 日 志 


Boot 对 Log4j 2 框架 的 使 用 。 


6.3.1 Log4j 2 简介 


Log4j Lx 版 本 虽然 已 经 广泛 使 用 于 很 多 应 用 程序 中 ， 然 而 ， 经 过 多 年 的 发 展 ， 它 的 发 展 速度 
已 经 变 缓 。 由 于 Log4j 1.x 需要 符合 Java 的 旧版 本 并 且 在 2015 年 8 月 已 经 寿终正寝 ， 因 此 维护 变 
得 更 加 困难 。Log4j 1.x 的 蔡 代 方案 SLF4J/Logback 对 框架 进行 了 许多 必要 的 改进 。 为 什么 要 使 用 


Log4j 2 We? 下 面 是 Log4j 官网 给 出 的 解释 。 


*  Log4j 2 被 设计 为 可 以 作为 审计 框架 使 用 .Log4j 1.x 和 Logback 都 会 在 重新 配置 的 时 候 失去 事 
件 ， 而 Log4j 2 不 会 。 在 Logback 中 ，Appender 中 的 异常 对 应 用 从 来 都 是 不 可 见 的 ， 但 


Log4j 2 的 Appender 可 以 设置 为 允许 将 异常 渗透 给 应 用 程序 。 


* Log4j2 包含 基于 LMAX Disruptor 库 的 下 一 代 异 步 日 志 器 。 在 多 线程 的 情况 下 ， 异 步 日 志 器 


具有 比 Log4j 1.x 和 Logback 高 出 10 倍 的 吞吐 性 能 以 及 更 低 的 延迟 。 


* Log4j 2 在 稳定 记录 状态 下 ， 对 单机 应 用 是 无 垃圾 的 ， 对 Web 应 用 是 低 垃圾 的 。 这 不 仅 降 低 


了 垃圾 回收 器 的 压力 ， 还 可 以 提供 更 好 的 响应 性 能 。 
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Log4j 2 使 用 插件 系统 ,使 得 它 非常 容易 通过 新 的 Appender、 Filter. Layout. Lookup 和 Pattern 
Converter 来 扩展 框架 ， 且 不 需要 对 Log4j 做 任何 修改 。 

由 于 插件 系统 的 配置 更 简单 了 ， 因 此 配置 项 不 需要 声明 类 名 称 。 

支持 自 定义 日 志 级 别 。 自 定义 日 志 级 别 可 以 在 代码 或 配置 中 定义 。 

支持 Lambda 表达 式 .运行 在 Java 8 上 的 客户 端 代码 可 以 使 用 Lambda 表达 式 实 现 仅 在 对 应 
的 日 志 级 别 启 用 时 延迟 构造 日 志 消息 。 由 于 不 需要 明确 地 层 层 把 关 ， 因 此 带 来 了 更 简洁 的 
代码 。 

Ad Message 对 象 。Message 支持 感 兴趣 或 复杂 的 结构 体 在 日 志 系统 中 传输 ， 且 可 以 被 高 效 
地 操作 。 用 户 可 以 自由 地 创建 他 们 自己 的 Message 类 型 ， 并 编写 自 定 义 的 Layout, Filter 和 
Lookup 来 操作 它们 。 

Log4j 1.x 支持 Appender 上 的 Filter。Logback 引入 了 TurboFilter 在 事件 被 Logger 处 理 之 前 对 
它们 进行 过 滤 。Log4j 2 支持 的 Filter 可 以 设置 为 在 被 Logger 接管 之 前 就 处 理事 件 ， 如同 它 在 
Logger 或 Appender 中 被 处 理 。 

很 多 Logback 的 Appender 不 接受 一 个 Layout， 且 只 能 发 送 固 定格 式 的 数据 。 而 大 多 数 Log4j 
2 的 Appender 接受 Layout， 允 许 数 据 以 任意 所 需 的 格式 传输 。 

Log4j 1.x 和 Logback 中 的 Layout 返回 一 个 String, 这 可 能 导致 一 些 编码 问题 Log4j 2 使 用 更 
简单 的 方法 ，Layout 总 是 返回 一 个 字 节 数组 。 优 点 是 这 意味 着 它们 可 以 用 于 任何 Appender, 
而 不 仅仅 是 写 入 OutputStream 中 的 那些 。 

Syslog Appender 既 支持 TCP 又 支持 UDP， 同 样 支持 BSD 系统 日 志 以 及 RFC 5424 格式 。 
Log4j 2 利用 了 Java 5 的 并 发 优势 , 并 且 尽 可 能 最 低 程度 上 进行 锁定 。Log4j Lx 中 已 知 存在 死 
锁 问 题 。 其 中 很 多 已 经 在 Logback 中 修复 , 但 很 多 Logback 的 class 文件 仍然 需要 在 更 高 的 编 
译 级 别 中 同步 。 


在 Log4j 官网 已 经 做 出 了 Log4j 2 与 其 他 日 志 框架 的 吞吐 量 对 比 图 ， 如 图 6-2 所 示 。 
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20,000,000 
18,000,000 m Logáj2: Loggers all async 
4j2: 

46,000,000 I Log4j2 : Loggers mixed sync/async 

mLog4j2: Async Appender 
14,000,000 m Log4j1: Async Appender 
12,000,000 mi Logback: Async Appender 
10,000,000 


JDK1.7.0 06 (64bit) on Solaris 10. 


4,000,000 4-core Xeon X5570 dual CPU @2.93GHz 
with hyperthreading switched on 
2,000,000 a (16 virtual cores) 
a LE ~ 


1thread 2threads 4threads 8threads 16threads 32 threads 64 threads 


6-2 Log4j2 与 其 他 日 志 框架 的 异步 吞吐 量 对 比 图 


从 图 6-2 中 可 以 看 到 ，Log4j 2 框架 与 其 他 框架 相 比 ， 线 程 数 越 多 ， 吞 叶 量 越 大 ， 性 能 优势 十 


分 明显 。 
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接 下 来 ， 我 们 再 看 一 下 官网 上 Log4j 2 与 其 他 日 志 框 架 的 响应 时 间 对 比 图 ， 如 图 6-3 所 示 。 


Async Logging Response Time (128,000 msg/sec, 16 threads - 8000 msg/sec/thread) 


800 


Logback 1.1.7 Async Appender 


600 
Log4j 1.2.17 Async Appender 


400 


Latency (milliseconds) 


200 


Log4j 2.6 Async Appender. 
0 Log4j 2.6 
0% 99% 99.99% 99.9999% Async Loggers 
90% 99.9% 99.999% 
Percentile 


图 6-3 Log4j2 与 其 他 日 志 框架 的 响应 时 间 对 比 图 


图 6-3 比较 了 Logback 1.1.7、Log4j 1.2.17 基于 ArrayBlockingQueue 的 异步 Appender 与 
Log4j 2.6 提供 的 异步 日 志 记录 的 各 种 选项 的 响应 时 间 延 迟 。 在 每 秒 128 000 个 消息 的 工作 负载 下 ， 
使 用 16 个 线程 〈 以 每 秒 8 000 个 消息 的 速率 进行 记录 ) ， 我 们 看 到 Logback 1.1.7、Log4j 1.2.17 38 
到 的 延迟 峰值 比 Log4j 2 大 几 个 数量 级 。 


6.3.2 Spring Boot 使 用 Log4j 2 


在 Spring Boot 中 使 用 Log4j 2 与 使 用 Log4j 的 过 程 类 似 。 首 先 ， 需 要 在 pom 文件 中 排除 默认 
日 志 框 架 并 引入 Log4j 2 依赖 ， 这 里 额外 加 入 了 Disruptor 依赖 ， 用 于 解决 Log4j2 日 志 版 本 较 低 报 
错 的 问题 ， 如 代码 清单 6-12 所 示 。 


代码 清单 6-12 Log4j 2 X H-Log4j 2 依赖 文件 


«dependency» 
XgroupId»org.springframework.boot«/groupId» 
Xartifactld^spring-boot-starter-web«/artifactId» 
Xexclusions» 

«exclusion» 
XgroupId»org.springframework.boot«/groupId»^ 
«artifactlId»spring-boot-starter-logging«/artifactlId» 

«/exclusion» 

«/exclusions» 

</dependency> 

<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-1og4j2</artifactId> 

</dependency> 
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<dependency> 
XgroupId»com.lmax«/groupId» 
XartifactId»disruptor«/artifactId» 
Xversion»3.4.2«/version» 


</dependency> 


6.3.3 ”控制 台 输 出 


我 们 先 来 看 一 下 如 何 使 用 Log4j 在 控制 台 输出 日 志 ， 首 先 在 src/main/resources 文件 夹 下 创建 
log4j2-spring.xml 文件 ， 如 代码 清单 6-13 所 示 。 


Log4j 2 项 目 -日 志文 件 输出 到 控制 台 


<?xml version-"1.0" encoding="UTF-8"?> 
«Configuration» 
«Properties» 
«Property name-"LOG PATTERN"»$d(yyyy-MM-dd HH:mm:ss:SSS) - $-51level 
- $pid - $t - $c(1.):$L - $m$n«/Property» 
«/Properties» 
«Appenders» 
«Console name-"Console" target-"SYSTEM OUT" follow-"true"» 
X«ThresholdFilter level-"trace" onMatch-"ACCEPT" onMismatch- 
"DENY" /> 
XPatternLayout pattern-"$(LOG PATTERN)"/» 
«/Console» 
X«/Appenders» 
XLoggers» 
«Root level-"info"» 
«AppenderRef ref-"Console"/» 
«/Root» 
«/Loggers» 
«/Configuration» 


内 容 很 好 理解 ， 其 中 : 


Property: 用 于 配置 自 定义 属性 ，name 是 属性 名 称 。 
Appenders: 用 于 定义 输出 日 志 类 型 。 

Console : 用 于 配置 输出 到 控制 台 的 配置 。 

ThresholdFilter: 定义 输出 的 日 志 级 别 。 

PatternLayout: 输出 日 志 的 格式 。 

Loggers: 在 这 里 引入 Appenders 才能 使 对 应 Appenders 生效 。 
AppenderRef: 定义 生效 的 Appenders。 
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6.34 日志 文件 输出 


接 下 来 我 们 学 习 如 何 将 日 志 输 出 到 日 志文 件 ， 如 代码 清单 6-14 所 示 。 


代码 清单 6-14 Log4j 2 项 目 -输出 日 志 到 日 志文 件 


«?xml version-"1.0" encoding-"UTF-8"?» 
«Configuration» 
«Properties» 
«Property name-"LOG PATTERN"»$d(yyyy-MM-dd HH:mm:ss:SSS) - $-5level 
- pid - $t - $c(1.):$L - $m$n«/Property» 
«Property name-"FILE PATH"»/Users/dalaoyang/logs/«/Property» 
«/Properties» 
<Appenders> 
<File name-"File" fileName="${FILE PATH)sys.log"> 
<PatternLayout> 
<pattern>${LOG PATTERN}</pattern> 
</PatternLayout> 
</File> 
</Appenders> 
<Loggers> 
<Root level="info"> 
<AppenderRef ref="File" /> 
</Root> 
</Loggers> 
</Configuration> 


这 里 的 配置 与 输出 到 控制 台大 致 相同 ， 只 不 过 将 Appenders 标签 内 的 Console 标签 蔡 换 为 File 
标签 。 


6.35 ”异步 日 志 


在 Log4j 官网 建议 开发 者 查看 日 志 的 方式 改 为 异步 方式 ,这 样 的 好 处 在 于 可 以 使 用 单独 的 线程 
来 打印 日 志 ， 提 高 日 志 效 率 ， 避 免 由 于 打印 日 志 而 影响 业务 功能 。 


1. AsyncAppender 方式 


官网 中 是 这 样 介绍 AsyncAppender 的 : AsyncAppender 是 通过 引用 别 的 Appender 来 实现 的 ， 
当 有 日 志 事 件 到 达 时 ， 会 开启 另 一 个 线程 来 处 理 它们 。 需 要 注意 的 是 ， 如 果 在 Appender 的 时 候 出 
现 异常 ， 对 应 用 来 说 是 无 法 感知 的 。AsyncAppender 应 该 在 它 引 用 的 Appender 之 后 配置 ， 默 认 使 
用 java.util.concurrent.ArrayBlockingQueue 实现 , 不 需要 其 他 外 部 的 类 库 。 当 使 用 此 Appender 的 时 
候 , 在 多 线程 的 环境 下 需要 注意 ， 阻 塞 队列 容易 受到 锁 争 用 的 影响 ， 这 可 能 会 对 性 能 产生 影响 。 这 
时 ， 我 们 应 该 考虑 使 用 无 锁 的 异步 记录 器 CAsyncLogger) 。 
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接 下 来 先 使 用 AsyncAppender 的 方式 使 用 异步 日 志 ， 如 代码 清单 6-15 所 示 。 


代码 清单 6 Log4j2 项 目 -AsyncAppender 输出 日 志 


<?xml version-"1.0" encoding-"UTF-8"?» 
«Configuration» 
«Properties» 
«Property name-"LOG PATTERN"»$d(yyyy-MM-dd HH:mm:ss:SSS) - $-5level 
- $pid - $t - $c(1.):$L - $m$n«/Property» 
«Property name-"FILE PATH"»/Users/dalaoyang/logs/«/Property» 


«/Properties» 
«Appenders» 
«File name-"File" fileName-"$(FILE PATH)sys.log"» 
«PatternLayout» 
«pattern»$(LOG PATTERN)«/pattern» 
«/PatternLayout» 
«/File» 


XAsync name-"ASYNC"» 
X«AppenderRef ref-"File"/» 
«/Async» 
«/Appenders» 
XLoggers» 
«Root level-"info"» 
X«AppenderRef ref-"ASYNC"/» 
«/Root» 
X/Loggers» 


«/Configuration» 


2. AsyncLogger 7; X 


AsyncLogger 是 官方 推荐 的 异步 方式 ， 它 提供 了 两 种 方式 使 用 异步 日 志 ， 即 全 局 异步 和 混合 异 
步 。 全 局 异步 是 指 所 有 的 日 志 都 进行 异步 的 日 志 记录 , 而 混合 异步 是 指 可 以 同时 使 用 同步 日 志和 异 
下 面 是 全 局 日 志 的 方式 ， 配 置 文件 如 代码 清单 6-16 所 示 。 


代码 清单 6 j Logger 输出 日 志 


<?xml version-"1.0" encoding-"UTF-8"?» 
«Configuration» 
«Properties» 
«Property name-"LOG PATTERN"»$d(yyyy-MM-dd HH:mm:ss:SSS) - $-5level 
- $pid - $t - $cí(1.):$L - $m$n«/Property» 
«Property name-"FILE PATH"»/Users/dalaoyang/logs/«/Property» 
«/Properties» 
<Appenders> 
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<RandomRccessFile name-"RandomAccessFile" fileName= 
"S(FILE PATHJasync.log" immediateFlush-"false" append="false"> 
<PatternLayout> 
«Pattern»$d $p $c(1.) [$t] $m $ex$n«/Pattern» 
«/PatternLayout» 
«/RandomAccessFile» 
«/Appenders» 
XLoggers» 
«Root level-"info"» 
«AppenderRef ref-"RandomAccessFile"/» 
«/Root» 
«/Loggers» 


«/Configuration» 


在 系统 初始 化 的 时 候 需 要 增加 全 局 配置 ， 如 代码 清单 6-17 所 示 。 


代码 清单 6-17 Log4j 2 项 目 -全 局 异步 日 志 参 数 配置 


System.setProperty ("log4j2.contextSelector, 
"org.apache.logging.10g4j.core.async.AsyncLoggerContextSelector"); 


你 可 以 在 第 一 次 获取 Logger 之 前 设置 , 也 可 以 选择 在 加 载 JVM 启动 参数 里 设置 , 如 代码 清单 
6-18 所 示 。 


代码 清单 6-18 Log4j 2 项 目 -全 局 异步 日 志 JVM 启动 参数 配置 


java 
-Dog4j2.contextSelector-org.apache.logging.log4j.core.async.AsyncLoggerConte 
xtSelector 


接 下 来 看 一 下 混合 异步 的 模式 ， 如 代码 清单 6-19 所 示 。 


Log4j 2 项 目 异步 日 志 参 数 配置 


<?xml version-"1.0" encoding-"UTF-8"?» 
«Configuration» 
«Properties» 
«Property name-"LOG PATTERN"»$d(yyyy-MM-dd HH:mm:ss:SSS) - $-51level 
- $pid - $t - $c(1.):$L - $m$n«/Property» 
«Property name-"FILE PATH"»/Users/dalaoyang/logs/«/Property^ 
«/Properties» 
«Appenders» 
XRandomAccessFile name-"RandomAccessFile" fileName- 
"S(FILE PATH)async.log" immediateFlush-"false" append-"false"» 
«PatternLayout» 
«Pattern»$d $p $c(1.) [$t] $m $ex$n«/Pattern» 
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</PatternLayout> 
</RandomAccessFile> 
</Appenders> 
<Loggers> 
<AsyncLogger name="com. springboot" level="info" includeLocation="true"> 
<AppenderRef ref="RandomAccessFile"/> 
</AsyncLogger> 
<Root level="info"> 
<AppenderRef ref-"RandomAccessFile"/» 
</Root> 
</Loggers> 


</Configuration> 


在 上 述 配 置 中 ，Root 的 Logger 是 同步 日 志 ， 而 com.springboot 的 Logger 是 异步 日 志 。 
Log4j 2 提供 了 很 优秀 的 异步 日 志 供 我 们 使 用 ， 尽 管 这 样 ， 我 们 也 没有 必要 盲目 追求 ， 毕 况 稳 
定 的 才 是 最 好 的 。 


6.4 ELK 日 志 收 集 


在 6.1~6.3 小 节 中 介绍 了 关于 Spring Boot 的 几 种 流行 的 日 志 框架 ， 但 在 微服 务 的 场景 下 ， 每 
个 服务 都 部 署 在 不 同 的 服务 器 中 ， 如 果 每 次 排查 问题 都 需要 挨个 服务 器 查看 日 志 , 就 太 麻烦 了 ， 所 
以 我 们 需要 对 日 志 进 行 集中 收集 ， 然 后 统一 查看 所 有 日 志 。 

当前 比较 流行 的 日 志 收 集 有 很 多 ， 本 节 以 ELK 为 例 CElasticsearch*Logstash*Kibana) 介绍 如 
何 进行 日 志 收 集 。 


6.4.1 ELK 日 志 收 集 流 程 介 绍 


简单 的 ELK 日 志 收集 流程 如 下 : 


(1) 在 微服 务 服务 器 上 部 署 Logstash， 对 日 志文 件 进行 数据 采集 ， 将 采集 到 的 数据 输出 到 
Elasticsearch 集群 中 。 
(2) Kibana 读 取 Elasticsearch 数据 ， 提 供 Web 展示 页 面 。 


64.2 ELK 安装 


接 下 来 介绍 ELK 的 安装 步骤 。 


1. Java 


Elasticsearch. Logstash 和 Kibana 都 需要 在 Java 环境 下 运行 , 所 以 需要 提前 在 服务 器 或 者 物理 
机 安装 Java， 如 果 需 要 ， 可 以 查看 本 书 安装 Java 的 过 程 ， 这 里 不 再 更 述 。 


156 | Spring Boot 2 实战 之 旅 


2. Elasticsearch 


登录 Elasticsearch 官网 ， 下 载 Elasticsearch 压缩 包 〈( 下 载 地 址 : https://www.elastic.co/cn/ 
downloads/elasticsearch) 。 这 里 以 Linux 安装 为 例 ， 首 先 下 载 压 缩 包 ， 这 里 下 载 6.5.4 版 本 ， 如 代 
码 清单 6-20 所 示 。 


代码 清单 6-20 ELK 项 目 - 下 载 Elasticsearch 代码 


wget https://artifacts.elastic.co/downloads/ elasticsearch/ 
elasticsearch-6.5.4.tar.gz 


下 载 完成 后 解压 文件 ， 如 代码 清单 6-21 所 示 。 


代码 清单 6-21 ELK 项 目 -解压 Elasticsearch 代码 


tar -zxvf elasticsearch-6.5.4.tar.gz 


3. Logstash 


无 论 是 什么 系统 , 首先 在 Logstash 官网 下 载 Logstash 压缩 包 ( 下 载 地 址 : https://www.elastic.co/ 
cn/downloads/logstash) ， 如 代码 清单 6-22 所 示 。 


代码 清单 6-22 ELK 项 目 - 下 载 Logstash 代码 


wget https://artifacts.elastic.co/downloads/logstash/logstash-6.5.4.tar.gz 


下 载 完成 后 解压 文件 ， 如 代码 清单 6-23 所 示 。 


代码 清单 6-23 ELK 项 目 -解压 Logstash 代码 


tar -zxvf logstash-6.5.4.tar.gz 


4. Kibana 


到 Kibana 官网 下 载 Kibana 压缩 包 〈( 下 载 地 址 : https://www.elastic.co/cn/ downloads/kibana) ， 
还 是 以 Linux 安装 为 例 ， 过 程 与 Logstash 类 似 ， 如 代码 清单 6-24 所 示 。 


代码 清单 6-24 ELK 项 目 -下 载 Kibana 代码 


wget https://artifacts.elastic.co/downloads/kibana/ 
kibana-6.5.4-linux-x86 64.tar.gz 


解压 Kibana 压缩 包 ， 如 代码 清单 6-25 所 示 。 


代码 清单 6-25 ELK 项 目 -解压 Kibana 代码 


tar -zxvf kibana-6.5.4-linux-x86 64.tar.gz 
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6.4.3 ELK 配置 


首先 启动 Elasticsearch， 进 入 Elasticsearch 安装 目录 的 bin 目录 下 ， 执 行 如 下 命令 启动 
Elasticsearch， 如 代码 清单 6-26 所 示 。 


代码 清单 6-26 ELK 项 目 -启动 Elasticsearch 


./elasticsearch 


这 里 以 收集 本 机 /Users/dalaoyang/logs/sys.log 日 志文 件 为 例 , 首先 查看 日 志文 件 内 容 ， 如 图 6-4 
所 示 。 


ndleriapping:373 


2018-12-01 


6-4 ELK 项 目测 试 日 志文 件 截图 
1. 配置 Kibana 


进入 Kibana 安装 目录 下 的 config 目录 ， 打 开 kibana.yml， 添 加 Elasticsearch 配置 ， 如 代码 清 
单 6-27 所 示 。 


代码 清单 6-27 ELK 项 目 -Kibana 配置 信息 


#Elasticsearch 主机 地 址 
elasticsearch.url: "http://localhost:9200" 
# 人 允许 远程 访问 


server.port: "0.0.0.0" 


然后 进入 Kibana 安装 目录 下 的 bin 目录 ， 输 出 如 下 命令 启动 Kibana， 如 代码 清单 6-28 所 示 。 


代码 清单 6-28 ELK 项 目 - 启 动 Kibana 


./kibana 


启动 后 控制 台 如 图 6-5 所 示 。 
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图 6-5 ELK 项 目测 试 日 志文 件 截图 
从 提示 中 可 以 看 到 ， 访 问 http://localhost:5601 可 以 查看 Kibana 的 Web 页 面 ， 如 图 6-6 所 示 。 


区 kibana 


可 视 化 和 探索 数据 管理 和 执行 Elastic 堆 栈 


(Qm kr me E ma S, mmr 


d 


图 6-6 ELK Kibana 首页 
2. 配置 Logstash 


进入 Logstash 目录 ，Logstash 一 般 读 取 conf 结尾 的 配置 文件 ， 所 以 创建 一 个 log2es.conf， 如 
代码 清单 6-29 所 示 。 


代码 清单 6-29 ELK 项 目 -Logstash 配置 信息 


# 从 日 志文 件 读 取 数 据 

#file{} 

#type 日 志 类 型 

#path 日 志 位 置 

+ 可 以 直接 读 取 文件 (a.1og) 

# 可 以 读 取 所 有 后 缀 为 log 的 日 志 C* .1og) 
# 读 取 文件 夹 下 所 有 文件 (路径 ) 


#start position 文件 读 取 开始 位 置 (beginning) 
#sincedb_path 从 什么 位 置 读 取 设置 为 /dev/null 自动 从 开始 位 置 读 取 ) 
input { 
file { 
type => "sys-log" 
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path => ["/Users/dalaoyang/logs/sys.log"] 
start position => "beginning" 
sincedb path -» "/dev/null" 


j 


# 数 据 的 输出 指向 了 es 集群 
#hosts Elasticsearch 主机 地 址 
#index Elasticsearch 索引 名 称 
output { 
elasticsearch ( 
hosts => "localhost:9200" 
index => "test-log-$(*YYYY.MM.dd]" 
) 
H 


配置 文件 内 容 解释 可 以 查看 代码 清单 中 的 注释 ， 这 里 就 不 再 介绍 了 。 接 下 来 启动 Logstash， 进 
入 Logstash 安装 目录 下 的 bin 目录 ， 输 入 启动 命令 ， 如 代码 清单 6-30 所 示 。 


代码 清单 6-30 ”ELK 项 目 -启动 Logstash 命令 


./logstash -f ../log2es.conf 


6.44 ”使 用 Kibana 查看 日 志 


在 ELK 三 者 都 启动 后 日 志 已 经 在 收集 了 ， 打 开 Kibana 系统 管理 ， 可 以 看 到 刚刚 创建 的 索引 
test-log-2019.01.19， 如 图 6-7 所 示 。 


er T Kitaa 
PIAR ERFIR ANAN 


Create index pattern 
"Eos ERES Cac HE POA vans 


Step 1 of 2: Define index pattern 


图 6-7 ELK Kibana 关联 索引 页 


160 | Spring Boot 2 实战 之 旅 


接 下 来 在 Index pattern 输入 框 中 输入 索引 名 称 test-log-2019.01.19( 这 里 可 以 使 用 通配符 * 等 ) ， 
然后 单 击 Next step 按钮 ， 显 示 如 图 6-8 所 示 的 页 面 。 


iocancet 


Managomer 


索引 模式 已 保存 对 象 AME 


Create ind 
k d x BERARI 


Step 2 cf 2: Configure settings 


dog as your index pattern Now you can specify some settings before we create 
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单 击 Create index pattern 按钮 创建 索引 ， 显 示 如 图 6-9 所 示 的 页 面 。 
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图 6-9 ELK Kibana 关联 索引 页 3 
在 如 图 6-9 所 示 的 页 面 中 可 以 查看 当前 索引 中 的 字段 , 因为 这 里 只 是 简单 使 用 , 所 以 没有 太 多 
字段 ， 如 果 需 要 ， 可 以 使 用 Logstash 自 定义 字段 。 接 下 来 ， 单 击 菜单 栏 中 的 “发 现 ” 按 钮 ， 然 后 
选择 索引 test-log-2019.01.19， 可 以 看 到 我 们 要 收集 的 日 志 内 容 已 经 收集 进来 了 ， 如 图 6-10 所 示 。 


an 


as 


tesciog2019 01.12 


Fi 6-10 ELK Kibana 索 引 查看 页 1 
接 下 来 测试 日 志 收集 ， 在 日 志文 件 中 最 下 面 一 行 追加 如 下 内 容 : 
测试 日 志 收集 。 
再 来 查看 Kibana， 页 面 如 图 6-11 所 示 。 


6-11 ELK Kibana 索引 查看 页 2 


从 图 6-11 中 可 以 看 到 ， 倒 数 第 二 条 就 是 刚刚 在 日 志文 件 中 输出 的 内 容 ， 由 于 笔者 一 不 小 心 多 
按 了 一 次 回 车 键 ， 将 回 车 键 显示 的 空白 数据 也 收集 到 了 。 


hau IM ————————————5 


6.4.5 Spring Boot 直接 输出 到 Logstash 


前 面 介绍 了 使 用 Logstash 对 日 志文 件 进行 收集 ， 其 实 也 可 以 将 Spring Boot 应 用 程序 直接 远程 
输出 到 Logstash 。 
这 里 以 Logback 日 志 为 例 ， 新 建 项 目 ， 在 项 目 中 加 入 Logstash 依赖 ， 如 代码 清单 6-31 所 示 。 


代码 清单 6-31 ELK 项 目 - Logstash 依赖 


<dependency> 
<groupId>net .logstash.logback</groupId> 
<artifactId>logstash-logback-encoder</artifactId> 
<version>5.3</version> 

</dependency> 


接 下 来 ， 在 src/resources 目录 下 创建 logback-spring.xml 配置 文件 ， 在 配置 文件 中 将 对 日 志 进 
行 格 式 化 ， 并 且 输 出 到 控制 台 和 Logstash。 需 要 注意 的 是 ， 在 destination 属性 中 配置 的 地 址 和 端口 
要 与 Logstash 输入 源 的 地 址 和 端口 一 致 ， 比 如 这 里 使 用 的 是 127.0.0.1:4560， 则 在 Logstash 输入 源 
中 要 与 这 个 配置 一 致 。 其 中 logback-spring.xml 内 容 如 代码 清单 6-32 所 示 。 


代码 清单 6-32 ELK 项 目 -logback-spring.xml 文件 内 容 


<?xml version-"1.0" encoding-"UTF-8"?» 
«configuration» 
«include resource-"org/springframework/boot/logging/logback/base.xml"/» 


Xappender name-"LOGSTASH" class-"net.logstash.logback.appender. 
LogstashTcpSocketAppender"» 
«destination»127.0.0.1:4560«/destination» 
<!-- 日 志 输 出 编码 --> 
<encoder charset="UTF-8" 
class-"net.logstash.logback.encoder. 
LoggingEventCompositeJsonEncoder"» 
«providers» 
«timestamp» 
«timeZone»UTC«/timeZone» 
«/timestamp» 
«pattern» 
«pattern» 
t 
"logLevel": "$level", 
"serviceName": "$(springAppName:-]", 
"pidr: UE 
"thread": "$thread", 
"class": "$logger(40)", 
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"rest": "$message" 
} 
</pattern> 
</pattern> 
</providers> 
</encoder> 
</appender> 


<root level="INFO"> 
<appender-ref ref="LOGSTASH" /> 
<appender-ref ref="CONSOLE" /> 
</root> 


</configuration> 


为 了 方便 起 见 ， 这 里 的 Logstash 只 是 将 日 志 输出 到 控制 台 ， 配 置 文件 内 容 如 代码 清单 6-33 
所 示 。 


代码 清单 6-33 ELK 项 目 -Logstash 配置 文件 内 容 


input { 
tcp ( 
mode -» "server" 
host => m127 0580/1 
port -» 4560 
codec => json lines 
2 
} 
output { 
stdout {codec => rubydebug} 
} 


启动 Logstash， 然 后 启动 应 用 程序 ， 查 看 Logstash 控制 台 即 可 看 到 日 志 输 出 ， 这 里 就 不 进行 
演示 了 。 


6.4.6 ELK 日 志 收集 优化 方案 及 建议 


ELK 的 简单 使 用 到 这 里 就 结束 了 。 如 果 数 据 特别 多 ， 上 述 方案 就 会 为 Elasticsearch 带 来 很 大 
的 压力 。 为 了 缓解 Elasticsearch 的 压力 , 可 以 将 Logstash 收集 的 内 容 不 直接 输出 到 Elasticsearch 中 ， 
而 是 输出 到 缓冲 层 ， 比 如 Redis 或 者 Kafka， 然 后 使 用 一 个 Logstash 从 缓冲 层 输出 到 Elasticsearch 。 
当然 ， 还 有 很 多 种 方案 进行 日 志 收 集 ， 比 如 使 用 Filebeat 蔡 换 Logstash 等 。 笔 者 在 生产 环节 搭建 过 
ELK 配置 ， 这 里 提 几 点 建议 : 
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(1) 根据 日 志 量 判断 Elasticsearch 的 集群 选择 ， 不 要 盲目 追求 高 可 用 ， 实 际 应 用 需要 根据 实 
际 场景 的 预算 等 因素 使 用 。 

(2) 缓冲 层 选择 ， 一 般 来 说 选择 Kafka 和 Redis。 虽 然 Kafka 作为 日 志 消息 很 适合 ， 具 备 高 
吞吐 量 等 ， 但 是 如 果 需 求 不 是 很 大 ， 并 且 环 境 中 不 存在 Kafka， 就 没有 必要 使 用 Kafka 作为 消息 组 
存 层 ， 使 用 现 有 的 Redis 也 未 尝 不 可 。 

G) 内 存 分 配 ，ELK 三 者 部 署 都 是 占有 一 定 内 存 的 ， 并 且 官 网 建议 的 配置 都 很 大 。 建 议 结合 
场景 来 修改 配置 ， 毕 竟 预 算是 很 重要 的 一 环 。 


6.5 小 结 


本 章 对 Spring Boot 的 几 种 日 志 框架 进行 了 学 习 ， 并 且 了 解 了 常用 的 日 志 收 集 方法 ， 相 信 经 过 
这 一 章 的 学 习 会 让 读者 对 日 志 的 了 解 有 一 定 的 提高 ， 从 而 对 系统 维护 等 有 更 好 的 手段 。 


Spring Boot 的 安全 之 旅 


安全 是 每 一 个 应 用 都 必须 面 对 的 问题 ， 一 个 应 用 如 果 没 有 设置 好 安全 框架 ， 那 么 很 容易 被 别 
人 利用 ， 进 而 做 一 些 非法 的 事情 。 我 们 可 以 做 一 个 这 样 的 假设 ， 比 如 应 用 中 没有 安全 框架 ， 意 味 着 
所 有 人 可 以 进行 所 有 操作 ， 这 样 对 于 一 些 后 台 系统 来 说 ， 就 会 造成 很 大 程度 的 风险 。 还 有 很 多 种 原 
因 ， 安 全 框架 就 这 样 诞生 。 本 章 将 介绍 常用 的 两 个 Java 安全 框架 : Apache Shiro 和 Spring Security; 
并 且 使 用 Spring Boot 结合 二 者 进行 简单 的 权限 控制 使 用 (本章 的 案例 只 是 将 Spring Boot 结合 安全 
框架 进行 认证 和 授权 ， 由 于 安全 框架 的 强大 及 功能 性 的 复杂 ， 因 此 并 没有 过 多 地 介绍 ， 如 果 基 础 很 
好 ， 或 者 对 安全 框架 很 了 解 ， 可 以 直接 跳 过 本 章 ) 。 


7.1 使 用 Shiro 安全 管理 


Shiro 是 由 Apache 开源 的 一 款 强大 的 安全 框架 ， 本 节 从 了 解 Shiro 框架 开始 ， 带 领 大 家 学 习 
Spring Boot 如 何 使 用 Shiro 进行 身份 认证 和 权限 认证 。 


7.4.1. 什么 是 Shiro 


Apache Shiro( 官 网 地 址 : http://shiro.apache.org/) 是 一 个 功能 强大 且 易 于 使 用 的 Java. 安全 框 
架 ， 可 以 利用 它 进行 身份 验证 、 授 权 、 加 密 和 会 话 管理 。 通 过 使 用 Shiro 易于 理解 的 API 文档， 可 
以 轻松 地 构建 任何 应 用 程序 。 

如 Apache Shiro 官网 所 说 ，Apache Shiro 的 首要 目标 是 易于 使 用 和 理解 。 安 全 有 时 可 能 非常 复 
杂 ， 甚 至 是 痛苦 的 ， 但 并 非 必须 如 此 。 框 架 应 尽 可 能 掩盖 复杂 性 ， 并 提供 简洁 直观 的 API， 以 简化 
开发 人 员 的 工作 ， 并 确保 其 应 用 程序 安全 地 工作 。 


166 


Spring Boot 2 实战 之 旅 


以 下 是 Apache Shiro 可 以 做 的 一 些 事情 : 


验证 用 户 身 份 。 

为 用 户 执行 访问 控制 ， 例 如 确定 是 否 为 用 户 分 配 了 菜 个 安全 角色 或 确定 是 否 允许 用 户 执 行 菜 
些 操作 。 

在 任何 环境 中 使 用 Session API， 即 使 没有 Web 容器 或 EJB 容器 也 是 如 此 。 

在 身份 验证 、 访 问 控制 或 会 话 生 命 周期 内 对 事件 做 出 反应 。 

聚合 用 户 安全 数据 的 一 个 或 多 个 数据 源 ， 并 将 其 全 部 显示 为 单个 复合 用 户 “ 视 图 ”。 
启用 单 点 登录 (SSO ) 功能 。 

无 须 登 录 即 可 为 用 户 关 联 启 用 “ 记 住 我 ”服务 。 


Apache Shiro 是 一 个 具有 许多 功能 的 综合 应 用 程序 安全 框架 ， 如 图 7-1 所 示 。 
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Management Cryptography 
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Web Support Caching 


v Supporting Features 
Remember 


Concurrency | Testing | "Run As" Me 


7-1 Apache Shiro 功能 图 


Shiro 提供 了 Shiro 开发 团队 所 称 的 “应 用 程序 安全 的 4 大 基石 ”一 一 身份 验证 、 授 权 、 会 话 
管理 和 加 密 。 


身份 认证 : 其 实 身份 认证 可 以 理解 为 “登录 ”。 


e dU: 授权 是 指 一 些 权 限 的 认证 ， 比 如 管理 员 可 以 访问 所 有 页 面 ， 但 是 普通 用 户 只 能 访问 部 


分 页 面 。 


o 会话 管 理 : 可 以 理解 为 Shiro 为 我 们 管理 用 户 的 会 话 (如 Session ). 


加 密 : 使 用 加 密 算 法 来 保证 数据 的 安全 。 


以 上 是 4 个 主要 的 功能 ， 如 图 7-1 所 示 ， 还 提供 了 其 他 功能 ， 分 别 说 明 如 下 。 


Web 支持 : Shiro 的 Web 支持 API 可 帮助 用 户 轻松 保护 Web 应 用 程序 。 

缓存 : Shiro 提供 了 缓存 ， 可 以 确保 安全 操作 保持 快速 高 效 。 

并 发 : Apache Shiro 支持 具有 并 发 功能 的 多 线程 应 用 程序 。 

测试 : 存在 测试 支持 以 帮助 用 户 编写 单元 和 集成 测试 ， 并 确保 代码 按 预期 受到 保护 。 
运行 方式 : 允许 用 户 假定 其 他 用 户 的 身份 ( 如果 人 允许 ) 的 功能 ， 有 时 在 管理 方案 中 很 有 用 。 
记 住 我 : 记 住 用 户 在 会 话 中 的 身份 ， 这 样 他 们 只 需要 在 强制 要 求 时 登录 。 
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7.1.2 ”使 用 Shiro 做 权限 控制 

刚刚 介绍 了 Apache Shiro 的 基本 功能 ， 接 下 来 带领 大 家 学 习 Spring Boot 如 何 使 用 Shiro 框架 
进行 身份 认证 和 权限 管理 。 

1. 场景 及 数据 库 介绍 

在 创建 项 目 之 前 ， 先 介绍 一 下 需要 实现 的 场景 ， 数 据 库 表 设计 如 图 7-2 所 示 。 


role 


P user id: int(11) P role id: int(11) P. menu kt in(11) 
pes word verde oos) role name: varchar(255) menu name. varchar(255) 
user. name: varchar(255) 


user role 


role menu 


中 role id: int(11) c 
menu id: int(11) 


图 7-2 Shiro 项 目 数据 库 设计 图 
其 中 分 为 两 种 角色 : admin 和 user, 如 果 用 户 角色 为 admin, 则 可 以 进行 4 个 菜单 的 请 求 (add、 
delete, update 和 select， 这 里 只 有 select 和 delete) ， 如 果 用 户 角色 为 user， 则 只 可 以 进行 select 
请 求 。 如 果 没 有 权限 ， 就 会 跳 转 到 401 页 面 ，index 页 面 可 以 不 登录 访问 。 为 了 方便 ， 默 认 插入 了 
两 个 用 户 : dalaoyang 有 admin 权限 ; xiaoli 有 user 权限 。 插 入 数据 脚本 如 代码 清单 7-1 所 示 。 


代码 清单 7-1 Shiro 项 目 数据 库 默认 数据 插入 SQL 


INSERT INTO “menu” 
INSERT INTO "menu^ 
INSERT INTO ^menu'(^menu id^, "menu name" 


(5 VALUES (1, 'add'); 
C 
C 

INSERT INTO ^menu' (menu id^, "menu name" 
C 
C 


VALUES (2, 'delete'); 
VALUES (3, 'update'); 
VALUES (4, 'select'); 


menu id^, "menu name” 
menu id^, "menu name” 


INSERT INTO `role` VALUES (1, 'admin'); 
INSERT INTO ^role'(^role id^, "role name") VALUES (2, 'user'); 
INSERT INTO ‘role menu'(^role id^, "menu id") VALUES (1, 1); 
INSERT INTO ^role menu'(^role id^, "menu id") VALUES (1, 2); 
INSERT INTO ^role menu'(^role id', "menu id^) VALUES (1, 3); 

) 

) 


role id^, ‘role name” 


INSERT INTO “role menu'(^role id^, "menu id') VALUES (1, 4); 

INSERT INTO ‘role menu'(^role id^, ‘menu id') VALUES (2, 4); 

INSERT INTO ^user'(^user id^, ‘pass word", "user name”) VALUES (1, '123', 
'dalaoyang!); 

INSERT INTO ‘user‘ (‘user id^, “pass word", "user name”) VALUES (2, '123', 
'"xiaoli'); 
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INSERT INTO ‘user role'(^role id^, ‘user id') VALUES (1, 1); 
INSERT INTO "user role'(^role id^, "user id') VALUES (2, 2); 
2. 依赖 配置 


接 下 来 我 们 新 建 一 个 项 目 ， 由 于 这 里 需要 使 用 数据 库 ， 因 此 加 入 了 MySQL 和 JPA 的 依赖 ， 
模板 框架 使 用 的 是 Thymeleaf， 同 时 加 入 Shiro 依赖 ， 如 代码 清单 7-2 所 示 。 


代码 清单 7-2 Shiro 项 目 依赖 文件 代码 


< 


</dependency> 
<dependency> 


</dependency> 
<dependency> 


</dependency> 
<dependency> 


</dependency> 
<dependency> 


</dependency> 
<dependency> 


</dependency> 


dependency> 
<groupId>org.apache.shiro</groupId> 
<artifactId>shiro-spring</artifactId> 
<version>1.4.0</version> 


XgroupId»org.springframework.boot«/groupId» 
X«artifactId»spring-boot-starter-web«/artifactId» 


XgroupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-thymeleaf«/artifactId» 


XgroupId»net.sourceforge.nekohtml«/groupId» 
X«artifactId»nekohtml«/artifactId» 
«version»1.9.15«/version» 


XgroupId»mysql«/groupId» 
XartifactId»mysql-connector-java«/artifactlId» 
Xscope»runtimec/scope» 


XgroupId»org.springframework.boot«/groupId» 
X«artifactlId^spring-boot-starter-data-jpa«/artifactId» 


配置 文件 这 里 不 再 袭 述 ， 都 是 关于 数据 库 和 JPA 的 配置 ， 如 需 查 阅 ， 可 以 在 本 书 源码 中 查看 。 


3 


. 实体 类 及 数据 操作 层 


结合 上 述 场景 ， 可 以 看 出 user 表 和 role 表 的 关系 是 多 对 多 , role 表 和 menu 表 的 关系 也 是 多 对 


£, H 


E 解 了 关系 ， 创 建 实体 类 就 比较 容易 了 。 首 先 创建 一 个 User 实体 ， 使 用 @ManyToMany 表明 


是 多 对 多 的 关系 ,在 @JoinTable 注解 中 注 明 中 间 表 的 表 名 以 及 关联 两 个 表 的 字段 ， 如 代码 清单 7-3 


所 示 。 
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-3 Shiro 项 目 数 据 库 User $ 


GEntity 
public class User implements Serializable ( 


Gerd 

GGeneratedValue 

private Integer userId; 
private String userName; 
private String passWord; 


GManyToMany(fetch- FetchType.EAGER) 

GJoinTable (name = "UserRole", joinColumns = (8JoinColumn (name = "userId")], 
inverseJoinColumns -(G8JoinColumn (name = "roleId") ]) 

private List«Role» roleList; 


..。// 这 里 省 略 set, get 方法 


接 下 来 创建 Role 实体 。 和 User 实体 类 似 ， 分 别 注 明 与 User 和 Menu 的 多 对 多 关系 ， 如 代码 
清单 7-4 所 示 。 


代码 清单 7-4 Shiro ME Role 实体 类 代 


GEntity 
public class Role implements Serializable ( 


Gerd 

GGeneratedValue 

private Integer roleId; 
private String roleName; 


GManyToMany(fetch- FetchType.EAGER) 

GJoinTable (name-"RoleMenu", joinColumns-(GJoinColumn (name-"roleId")], 
inverseJoinColumns-(Q(JoinColumn (name-"menuId")]) 

private List«Menu» menuList; 


GManyToMany 

GJoinTable (name-"UserRole",joinColumns-(GJoinColumn (name-"roleId")], 
inverseJoinColumns- (QJoinColumn (name-"userId")]) 

private List«User» userList; 


..。// 这 里 省 略 set. get 方法 


最 后 是 Menu 实体 ， 这 里 表明 与 Role 的 多 对 多 关系 ， 如 代码 清单 7-5 所 示 。 
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代码 清单 7-5 Shiro 项 目 Menu 实体 类 代码 


GEntity 
public class Menu implements Serializable ( 


Gerd 

GGeneratedValue 

private Integer menuId; 
private String menuName; 


GManyToMany 

GJoinTable (name-"RoleMenu", joinColumns-(G0JoinColumn (name-"menuId")], 
inverseJoinColumns-(G8JoinColumn (name-"roleId")])) 

private List«Role» roleList; 


。// 这 里 省 略 set、get 方法 
} 


创建 一 个 JPA 数据 操作 层 ， 里 面 加 入 一 个 根据 用 户 名 查询 用 户 的 方法 ， 如 代码 清单 7-6 所 示 。 


代码 清单 7-6 Shiro 项 目 UserRepository 类 代码 


public interface UserRepository extends JpaRepository«User,Long»? { 
User findByUserName (String username); 
} 


4. Shiro 配置 


创建 一 个 ShiroConfig， 然 后 创建 一 个 shiroFilter 方法 。 在 Shiro 使 用 认证 和 授权 时 ， 其 实 都 是 
通过 ShiroFilterFactoryBean 设置 一 些 Shiro 的 拦截 器 进行 的 , 拦截 器 会 以 LinkedHashMap 的 形式 存 
储 需 要 拦截 的 资源 及 链接 , 并 且 会 按照 顺序 执行 , 其 中 键 为 拦截 的 资源 或 链接 , 值 为 拦截 的 形式 ( 比 
如 authc: 所 有 URL 都 必须 认证 通过 才 可 以 访问 ，anon: 所 有 URL 都 可 以 匿名 访问 ) ， 在 拦截 的 过 程 
中 可 以 使 用 通配符 ， 比 如 /#* 为 拦截 所 有 ， 所 以 一 般 /#t* 放 在 最 下 面 。 同 时 ， 可 以 通过 
ShiroFilterFactoryBean 设置 登录 链接 、 未 授权 链接 、 登 录 成 功 跳 转 页 等 ， 这 里 设置 的 shiroFilter 方 
法 内 容 如 代码 清单 7-7 所 示 。 


代码 清单 7-7 Shiro 项 目 ShiroConfig 类 shiroFilter 方 法 代码 


GBean 
public ShiroFilterFactoryBean shiroFilter (SecurityManager securityManager)( 
ShiroFilterFactoryBean shiroFilterFactoryBean - new 
ShiroFilterFactoryBean(); 
shiroFilterFactoryBean.setSecurityManager (securityManager); 
//shiro 拦截 器 
Map<String,String> filterChainDefinitionMap = new 
LinkedHashMapcString,String»(); 
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//«1-- authc: 所 有 URL 都 必须 认证 通过 才 可 以 访问 ,anon: 所 有 URL 都 可 以 匿名 访问 --> 
//<!-- 过 滤 链 定 义 ， 从 上 向 下 顺序 执行 ， 一 般 将 /** 放 在 最 下 面 --> 


// 配置 不 被 拦截 的 资源 及 链接 
filterChainDefinitionMap.put("/static/**", "anon"); 
// 退出 过 滤器 

filterChainDefinitionMap.put("/logout", "logout"); 


// 配 置 需要 认证 权限 
filterChainDefinitionMap.put("/**", "authc"); 
// 默认 寻找 登录 链接 
shiroFilterFactoryBean.setLoginUrl("/login"); 
// 登录 成 功 后 要 跳 转 的 链接 


shiroFilterFactoryBean.setSuccessUrl("/index"); 


// 未 授权 的 跳 转 链接 

shiroFilterFactoryBean.setUnauthorizedUrl ("/401"); 

shiroFilterFactoryBean.setFilterChainDefinitionMap 
(filterChainDefinitionMap); 

return shiroFilterFactoryBean; 


) 


同时 ， 需 要 在 ShiroConfig 类 中 开启 shiro aop 注解 支持 ， 如 果 没 有 开启 ， 权 限 验 证 就 会 失效 ， 
如 代码 清单 7-8 所 示 。 


代码 清单 7-8 Shiro 项 目 AuthorizationAttributeSourceAdvisor 方法 代码 


GBean 
public AuthorizationAttributeSourceAdvisor 
authorizationAttributeSourceAdvisor(SecurityManager securityManager)( 
AuthorizationAttributeSourceAdvisor 
authorizationAttributeSourceAdvisor - new 
AuthorizationAttributeSourceAdvisor(); 
authorizationAttributeSourceAdvisor.setSecurityManager 
(securityManager); 
return authorizationAttributeSourceAdvisor; 
) 


接 下 来 创建 一 个 方法 处 理 一 些 异常 信息 ， 如 代码 清单 7-9 所 示 。 


代码 清单 7-9 Shiro 项 目 createSimpleMappingExceptionResolver 方法 代码 


GBean (name-"simpleMappingExceptionResolver") 
public SimpleMappingExceptionResolver 
createSimpleMappingExceptionResolver() ( 
SimpleMappingExceptionResolver simpleMappingExceptionResolver - new 
SimpleMappingExceptionResolver(); 
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Properties mappings = new Properties(); 

// 数 据 库 异 常 处 理 

mappings.setProperty ("DatabaseException", "databaseError"); 
// 未 经 过 认证 

mappings.setProperty ("UnauthorizedException","401"); 

// None by default 
simpleMappingExceptionResolver.setExceptionMappings (mappings); 
// No default 
simpleMappingExceptionResolver.setDefaultErrorView ("error"); 
// Default is "exception" 
simpleMappingExceptionResolver.setExceptionAttribute ("ex"); 
return simpleMappingExceptionResolver; 


) 


最 后 , 我 们 需要 在 ShiroConfig 内 设置 自 定义 身份 认证 的 Realm, 完整 ShiroConfig 类 代码 可 在 


本 书 源 代码 中 查看 。MyShiroRealm 类 代码 如 代码 清单 7-10 所 示 。 


代码 清单 7-10 Shiro Xi El MyShiroRealm 类 代码 


principals) ( 


SimpleAuthorizationInfo(); 


(AuthenticationToken token) 


GConfiguration 
public class MyShiroRealm extends AuthorizingRealm ( 


GResource 
private UserRepository userRepository; 


// 授 权 方 法 ， 主 要 用 于 获取 角色 的 菜单 权限 


GOverride 
protected AuthorizationInfo doGetAuthorizationInfo (PrincipalCollection 


SimpleAuthorizationInfo authorizationInfo - new 


User userInfo - (User)principals.getPrimaryPrincipal(); 
for (Role role:userInfo.getRoleList())( 
authorizationInfo.addRole (role.getRoleName ()); 
for (Menu menu:role.getMenuList()){ 
authorizationInfo.addStringPermission (menu.getMenuName ()) ; 


ji 
return authorizationinfo; 


// 认 证 方法 ， 主 要 用 于 校 验 用 户 名 和 密码 
GOverride 
protected AuthenticationInfo doGetAuthenticationInfo 


173 


第 7 章 Spring Boot 的 安全 之 旅 


throws AuthenticationException ( 
// 获 得 当前 用 户 的 用 户 名 
String username = (String)token.getPrincipal(); 
// 根 据 用 户 名 查询 用 户 
User user = userRepository.findByUserName (username); 
if(user -- null)( 
return null; 
) 
// 校 验 用 户 名 、 密 码 是 否 正确 
SimpleAuthenticationInfo authenticationInfo = new 
SimpleAuthenticationInfo( 
user, 
user.getPassWord(), 
getName () 
YA 
return authenticationInfo; 


) 


其 中 ，doGetAuthorizationInfo 方法 用 于 授权 ，doGetAuthenticationInfo 方法 用 于 验证 用 户 信息 ， 


也 就 是 我 们 常 说 的 登录 。 
5. 前 端 页 面 


本 案例 中 场景 设计 为 5 个 页 面 , 分 别 是 401 页 面 、delete 页 面 、index 页 面 、login 页 面 及 Select 


页 面 401 页 面 的 代码 。 如 代码 清单 7-11 所 示 。 
代码 清单 7-11 Shiro 项 目 401 页 面 代码 


<!DOCTYPE html» 

<html lang-"en"» 

<head> 
<meta charset="UTF-8"> 
<title>401</title> 

</head> 

<body> 

401 

</body> 

</html> 


delete 页 面 的 代码 如 代码 清单 7-12 所 示 。 


代码 清单 7-12 Shiro MA delete 页 面 代码 


<!DOCTYPE html> 
<html lang="en"> 


<head> 
«meta charset-"UTF-8"» 
«title»Title«/title» 

</head> 

<body> 

delete 

</body> 

</html> 


index 页 面 中 设置 了 一 个 注销 按钮 ， 如 代码 清单 7-13 所 示 。 


代码 清单 7-13 Shiro 项 目 index 页 面 代码 


<!DOCTYPE html» 
<html lang-"en" xmlns:th="http://www.w3.0rg/1999/xhtml"> 
<head> 
<meta charset="UTF-8"> 
<title>Title</title> 
</head> 
<body> 
index 
<br/> 
<form th:action="@{/logout}" method="post"> 
"注销 "/></p> 


<p><input type="submit" value= 
</form> 
</body> 
</html> 


login 页 面 通过 表单 提交 数据 ， 如 代码 清单 7-14 所 示 。 


代码 清单 7-14 Shiro WA login 页 面 代码 


<!DOCTYPE html> 
<html lang-"en" xmlns:th-"http://www.w3.0rg/1999/xhtml"» 


<head> 
<meta charset="UTF-8"> 
<title>Login</title> 
</head> 
<body> 


错误 信息 : <h4 th:text="${msg}"></h4> 

<form action-"" method-"post"» 
<p> 账 号 : «input type="text" name-"username" value-"dalaoyang"/»«/p» 
«p» 4H: «input type="text" name-"password" value-"123"/»«/p» 
<p><input type="submit" value=" 登 录 "/></p> 

</form> 
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</body> 
</html> 


最 后 是 select 页 面 ， 代 码 如 代码 清单 7-15 所 示 。 


代码 清单 7-15 Shiro MA select 页 面 代码 


<!DOCTYPE html» 

<html lang-"en"» 

<head> 
<meta charset="UTF-8"> 
<title>Title</title> 

</head> 

<body> 

select 

</body> 

</html> 


6. Controller 


最 后 需要 创建 Controller 进 行 页 面 跳 转 , @RequiresPermissions 注解 设置 select 方 法 应 该 有 select 
权限 ，@RequiresRoles 注解 设置 delete 方法 需要 有 admin 的 角色 。 其 实 Shiro 提供 了 如 下 几 个 注解 
供 使 用 。 
* @RequiresAuthentication: 表示 当前 已 经 通过 了 身份 认证 ， 即 Subject. isAuthenticated() 返 回 
true, 
(QRequiresUser: 表示 当前 用 户 已 经 通过 身份 验证 或 者 通过 “ 记 住 我 ”登录 的 
@RequiresRoles: 可 以 通过 属性 值 value 设 置 角色 , 角色 可 以 设置 一 个 或 者 多 个 , 并 且 使 用 logical 
属性 指定 角色 需要 同时 包含 多 个 权限 还 是 只 包含 一 个 权限 。 比 如 @RequiresRoles (value "admin", 
"user"}, logical= Logical.AND) 为 当前 需要 用 户 同时 包含 admin 和 user 权限 。 

* @RequiresPermissions: 与 上 面 的 注解 类 似 ， 判断 用 户 是 否 含有 菜单 权限 ， 属 性 值 与 
(@RequiresRoles 一 致 。 

* @RequiresGuest: 表明 当前 用 户 没有 通过 身份 验证 或 通过 “ 记 住 我 ”登录 过 ， 也 就 是 游客 身份 。 


接 下 来 ， 我 们 看 一 下 ShiroController 的 代码 ， 需 要 注意 login 方法 中 根据 HttpServletRequest 
获取 Shiro 处 理 的 异常 信息 来 给 出 一 些 提示 ， 比 如 用 户 名 不 存在 或 者 密码 错误 。 完 整 代码 如 代码 清 
单 7-16 所 示 。 


代码 清单 7-16 Shiro WA ShiroController 类 代码 


GController 

public class ShiroController { 
GGetMapping(("/","/index"]) 
public String index()( 
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return"index"; 


GGetMapping("/401") 
public String unauthorizedRole()( 
return "401"; 


GGetMapping("/delete") 

GRequiresRoles ("admin") 

public String delete()( 
return "delete"; 


GGetMapping("/select") 

GRequiresPermissions ("select") 

public String select (){ 
return "select"; 


GRequestMapping ("/1login") 
public String login (HttpServletRequest request, Map«String, Object» map) ( 
// 如 果 登 录 失 败 ， 就 从 HttpServletRequest 中 获取 shiro 处 理 的 异常 信息 ， 获 取 
shiroLoginFailure 就 是 shiro 异常 类 的 全 名 
String exception = (String) request.getAttribute ("shiroLoginFailure"); 
String msg = ""; 
// 根 据 异 常 判断 错误 类 型 
if (exception != null) ( 
if (UnknownAccountException.class.getName ().equals(exception)) { 
msg = "用 户 名 不 存在 ! "; 
) else if (IncorrectCredentialsException.class.getName(). 
equals(exception)) ( 
msg = "密码 错误 ! "; 
) else ( 
msg 


exception; 


5 
map.put("msg", msg); 
return "/login"; 


GGetMapping("/logout") 
public String logout (){ 
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return "/login"; 


$ 
7. 测试 
到 这 里 ， 项 目 就 已 经 配置 完成 了 。 启 动 项 目 ， 这 里 简单 介绍 一 下 笔者 用 来 测试 的 方法 。 
CD. 在 不 登录 的 情况 下 可 以 访问 index I login 页 面 ， 访 问 select HHA delete 页 面 会 跳 转 到 
login 页 面 。 
(2) 使 用 dalaoyang 用 户 登录 的 话 ， 可 以 在 登录 后 访问 任意 页 面 。 
(3) 使 用 xiaoli 用 户 登 录 的 话 ， 除 了 访问 delete 页 面 会 跳 转 到 401 页 面 以 外 ， 访 问 其 他 页 面 
都 会 正常 跳 转 。 
通过 以 上 测试 , 完全 可 以 测试 出 Shiro 框架 做 到 了 认证 及 授权 。 读者 也 可 以 使 用 其 他 方式 进行 
测试 ， 如 果 读 者 对 Shiro 感 兴趣 ， 可 以 在 此 基础 上 进行 扩展 ， 使 用 更 多 的 功能 。 


7.2 使 用 Spring Security 


Spring Security (官网 地 址 : https://spring.io/projects/spring-security) 是 Spring 家 族 的 安全 框架 ， 
本 节 将 介绍 使 用 Spring Boot 结合 Spring Security 进行 身份 认证 和 权限 认证 。 


7.2.1 Spring Security 简介 


Spring Security 是 一 个 能 够 为 基于 Spring 的 企业 应 用 系统 提供 声明 式 的 安全 访问 控制 解决 方案 
的 安全 框架 。 它 提供 了 一 组 可 以 在 Spring 应 用 上 下 文中 配置 的 Bean， 充 分 利用 了 Spring IoC 
CInversion of Control， 控 制 反 转 ) ~ DI (Dependency Injection， 依 赖 注入 ) 和 AOP (面向 切面 编 
FE) 功能 ,为 应 用 系统 提供 声明 式 的 安全 访问 控制 功能 , 减少 了 为 企业 系统 安全 控制 编写 大 量 重复 
代码 的 工作 。 
Spring Security 提供 了 非常 多 强大 且 常 用 的 功能 。 
身份 认证 : Spring Security 提供 了 多 粒度 的 身份 认证 ， 最 熟悉 的 就 是 我 们 常用 的 登录 功能 。 
o A: 通俗 地 说 ， 授 权 是 指 权 限 认 证 。 当 你 向 服务 器 发 起 一 个 请 求 时 ， 服 务 器 会 对 你 的 权限 
进行 验证 ， 如 果 权限 不 足 ， 就 可 能 重 定向 到 特定 的 界面 或 返回 HTTP 响应 码 。 
* Jv: Spring Security 提供 了 多 种 加 密 方式 供 我 们 使 用 (如 SHA、MD5 或 Bcrypt)， 可 以 根 
据 需 求 选择 。 
e ”会 话 管理 : Spring Security 拥有 特殊 的 会 话 管理 机 制 ,会 对 会 话 进行 保护 、 定 期 检测 会 话 是 否 
超时 等 。 
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Session 管理 : 如 果 有 需要 的 话 ， 那 么 可 以 配置 Spring Security 检测 无 效 的 Session ID 提交 并 
将 用 户 重 定向 到 一 个 指定 的 URL. 

支持 HTTP/HTTPS: 支持 服务 器 同时 使 用 HTTP 和 HTTPS， 如 果 需 要 特殊 URL， 那 么 只 能 
使 用 HTTPS， 可 以 在 配置 中 直接 配置 进行 使 用 。 

支持 Basic 和 Digest 认证 : Basic (基本 ) 验证 和 Digest ( 摘要 ) 验证 是 在 Web 应 用 中 流行 的 
替代 身份 验证 机 制 。 基 本 验证 是 指 在 客户 端 请 求 时 ， 提 供用 户 名 和 密码 验证 的 一 种 方式 ， 常 
见 的 如 EUREKA。 摘 要 认证 属于 基本 认证 的 升级 版 ， 将 传输 的 密码 加 密 ， 解 决 了 HTTP 基本 
认证 不 安全 的 问题 。 

Remember-Me: Remember-Me 身份 验证 是 指 网 站 能 够 记 住 一 个 主体 的 身份 之 间 的 会 话 。 当 第 
一 次 登录 时 ， 服 务 器 发 送 cookie 给 浏览 器 ， 浏 览 器 将 cookie 保存 一 段 时 间 ， 当 再 次 访问 时 ， 

如 果 在 会 话 中 发 现 cookie， 则 进行 自动 登录 。 

提供 CSRF 解决 方案 : CSRF X Cross Site Request Forgery 的 缩写 ,CSRF 是 指 跨 站 请 求 伪造 。 
是 一 种 通过 伪装 成 受信 任用 户 的 请 求 来 利用 受信 任 的 网 站 .Spring Security 提供 了 解决 这 个 问 
题 的 方案 。 


* CORS: Spring Security 提供 了 对 CORS ( 跨 域 资源 共享 ) 的 支持 。 


安全 HTTP 响应 头 : Spring Security 支持 将 各 种 安全 头 添加 到 响应 中 。 
匿名 身份 验证 : 允许 未 经 过 身份 验证 的 用 户 访问 。 


除 以 上 介绍 的 功能 之 外 ， 还 提供 了 很 多 功能 ， 有 具体 需求 的 读者 可 以 查看 官方 文档 “对 症 下 


药 ”。 笔 者 就 不 在 这 里 做 过 多 介绍 了 ， 毕 竟 Spring Security 不 是 一 节 内 容 能 介绍 完 的 。 


7.2.2 ”使 用 Spring Security 做 权限 控制 


接 下 来 还 是 使 用 7.1 节 Spring Boot 结合 Shiro 的 场景 ， 使 用 Spring Boot 结合 Spring Security 


实现 同样 的 功能 。 


1. 场景 及 初始 化 数据 
场景 在 这 里 不 做 过 多 介绍 ， 可 以 查看 7.1 节 的 场景 。 数 据 库 表 也 没有 做 大 量 修改 ， 稍 微 修改 了 


一 下 Role 表 的 数据 。 需 要 注意 ， 这 里 由 原来 的 user 修改 成 了 ROLE USER. admin 修改 成 了 
ROLE ADMIN ( 稍 后 会 进行 解释 ) 。 初 始 化 数据 SQL 如 代码 清单 7-17 所 示 。 


代码 清单 7-17 Spring Security 项 目 初始 化 数据 代码 


INSERT INTO "menu'(^menu id', ‘menu name”) VALUES (1, '/add'); 
INSERT INTO ^menu'(^menu id^, "menu name') VALUES (2, '/delete'); 
INSERT INTO ‘menu‘ (‘menu id^, ‘menu name”) VALUES (3, '/update'); 
INSERT INTO ^menu' ("menu id^, "menu name”) VALUES (4, '/select'); 
INSERT INTO ^role'(^role id^, ^role name”) VALUES (1, 'ROLE ADMIN'); 
INSERT INTO ^role'(^role id^, ^role name”) VALUES (2, 'ROLE USER'); 
INSERT INTO ^role menu (‘role id^, ‘menu id') VALUES (1, 1); 

INSERT INTO “role menu" (role id^, "menu id^) VALUES (1, 2); 
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INSERT INTO “role menu'(^role id^, ‘menu id') VALUES (1, 3); 

INSERT INTO ‘role menu' ("role id', "menu id') VALUES (1, 4); 

INSERT INTO ^role menu'(^role id^, "menu id^) VALUES (2, 4); 

INSERT INTO ^user' (‘user id', ‘pass word', ‘user name”) VALUES (1, '123', 
'dalaoyang!); 

INSERT INTO ^user'(^user id^, "pass word', "user name”) VALUES (2, '123', 
'xiaoli'); 

INSERT INTO "user role" (“role id^, "user id') VALUES (1, 1); 

INSERT INTO ‘user role' (role id^, "user id^) VALUES (2, 2); 


2. 依赖 文件 及 配置 文件 


新 建 项 目 ， 依 赖 内 容 与 7-1 小 节 类 似 ， 只 需要 将 Shiro 依赖 蔡 换 为 Spring Security 依赖 ， 完 整 
内 容 如 代码 清单 7-18 所 示 。 


项 目 依赖 文件 


«dependency» 
XgroupId»org.springframework.boot«/groupId» 
X«artifactId»spring-boot-starter-web«/artifactId» 
</dependency> 
<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-security</artifactId> 
</dependency> 
<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-thymeleaf</artifactId> 
</dependency> 
<dependency> 
<groupId>net .sourceforge.nekohtml</groupId> 
<artifactId>nekohtml</artifactId> 
<version>1.9.15</version> 
</dependency> 
<dependency> 
<groupId>mysql</groupId> 
<artifactIid>mysql-connector-java</artifactId> 
<scope>runtime</scope> 
</dependency> 
<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-data-jpa</artifactId> 
</dependency> 


配置 文件 这 里 不 青 袭 述 ， 都 是 关于 数据 库 和 JPA 的 配置 ， 如 需 查阅 ， 可 以 在 本 书 源 代码 处 查看 。 
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3. 实体 类 


实体 类 也 可 以 采用 7.1 节 的 实体 类 ， 由 于 篇 幅 原 因 ， 代 码 就 不 再 展示 了 。UserRepository 类 同 
样 提供 了 一 个 findByUserName 方法 。 另 外 ， 由 于 场景 需求 ， 需 要 创建 一 个 RoleRepository， 如 代 


DI 


É 7-19 所 示 。 


代码 


清单 7-19 Spring Security Iii A RoleRepository 类 代码 


public interface RoleRepository extends JpaRepository«Role,Integer» ( 
) 


4. SecurityConfig 


使 用 Spring Security 进行 安全 管理 需要 使 SecurityConfig 继承 WebSecurityConfigurerAdapter 
类 ， 并 且 使 用 HttpSecurity 的 一 切 安全 策略 进行 配置 。 本 文 使 用 的 配置 如 下 。 


authorizeRequests: 配置 一 些 资源 或 链接 的 权限 认证 。 

antMatchers: 配置 哪些 资源 或 链接 需要 被 认证 。 

permitAll: 设置 完全 允许 访问 的 资源 和 链接 。 

hasRole: 配置 需要 认证 的 资源 或 链接 的 角色 。 需 要 注意 ， 若 这 里 需要 配置 权限 为 USER， 则 
用 户 需要 拥有 权限 ROLE_USER， 这 就 是 初始 化 脚本 中 权限 内 容 修改 的 原因 。 
formLogin: 设置 form 表单 提交 配置 。 

loginPage: 设置 一 个 自 定义 的 登录 页 面 URL. 

failureUrl: 设置 一 个 自 定义 的 登录 失败 的 URL。 

successForwardUrl: 设置 一 个 登录 成 功 后 自动 跳 转 的 URL. 

accessDeniedPage: 设置 拒绝 访问 的 URL. 

logoutSuccessUrl: 设置 退出 登录 的 URL. 


正如 初始 化 脚本 中 可 以 看 到 的 ， 在 数据 库 中 设置 了 两 个 用 户 ， 笔 者 在 内 存 中 使 用 
configureGlobal 设置 了 两 个 用 户 test 和 admin， 其 中 test 用 户 的 初始 密码 是 123， 权 限 为 USER， 


admin 


用 户 的 初始 密码 123， 权 限 是 ADMIN 和 USER。 由 于 本 文 没有 给 密码 设置 加 密 ， 因 此 需要 


定义 一 个 NoOpPasswordEncoder 的 Bean 来 设置 密码 不 加 密 。 完 整 SecurityConfig 内 容 如 代码 清单 
7-20 所 示 。 


代码 清单 7-20 Spring Security WA SecurityConfig 类 代码 


GEnableWebSecurity 
public class SecurityConfig extends WebSecurityConfigurerAdapter ( 


GAutowired 

private RoleRepository roleRepository; 

GAutowired 

private MyUserDetailsService myUserDetailsService; 
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GOverride 
protected void configure(HttpSecurity httpSecurity) throws Exception( 
// 配 置 资源 文件 ， 其 中 /css/**、/index 可 以 任意 访问 ，/select 需要 USER 权限 ， 
/delete 需要 ADMIN 权限 
httpSecurity 
.authorizeRequests () 
.antMatchers ("/css/**", "/index").permitAll() 
.antMatchers ("/select") .hasRole ("USER") 
-antMatchers ("/delete") .hasRole ("ADMIN"); 
// 动 态 加 载 数据 库 中 的 角色 权限 
List<Role> roleList = roleRepository.findAll(); 
for (Role role : roleList)( 
List«Menu» menuList = role.getMenuList(); 
for (Menu menu : menuList)( //f£ Spring Security 中 校 验 权 
限 的 时 候 ， 会 自动 在 权限 前 面 加 ROLE_， 所 以 我 们 需要 将 数据 库 中 配置 的 ROLE 截取 掉 
String roleName = role.getRoleName().replace("ROLE ",""); 
String menuName = "/" + menu.getMenuName(); 
httpSecurity 
.authorizeRequests() 
.antMatchers (menuName) 
.hasRole (roleName); 


) 
// 配 置 登 录 请 求 /1ogin 登录 失败 请 求 /1ogin_error 登录 成 功 请 求 / 
httpSecurity 
-formLogin() 
.loginPage ("/login") 
-failureUrl("/login error") 
.successForwardUrl ("/"); 
// 登 录 异 常 ， 如 权限 不 符合 ， 请 求 /401 
httpSecurity 
.exceptionHandling() .accessDeniedPage ("/401"); 
// 注 销 登录 ， 请 求 /10gout 
httpSecurity 
.logout () 
-logoutSuccessUrl ("/logout"); 


GBean 
public static NoOpPasswordEncoder passwordEncoder() { 
return (NoOpPasswordEncoder) NoOpPasswordEncoder.getInstance(); 
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// 根 据 用 户 名 密码 实现 登录 
GAutowired 
public void configureGlobal (AauthenticationManagerBuilder 
authenticationManagerBuilder) throws Exception ( 
authenticationManagerBuilder 
.inMemoryAuthentication() 
//.passwordEncoder (new BCryptPasswordEncoder ()) 
.withUser("test").password("123").roles ("USER") 
.and() 
.withUser ("admin") .password ("123") .roles ("ADMIN", "USER") ; 
authenticationManagerBuilder.userDetailsService 
(myUserDetailsService); 
b 
) 


5. MyUserDetailsService 


使 用 数据 库 认 证 用 户 需要 自 定 义 一 个 类 来 实现 UserDetailsService *& *; loadUserByUsername 77 
法 进行 认证 授权 ， 如 代码 清单 7-21 所 示 。 


青 单 7-21 Spring Security 项 目 MyUserDetailsService 代码 


GService 
public class MyUserDetailsService implements UserDetailsService ( 
GAutowired 


private UserRepository userRepository; 


GOverride 
public UserDetails loadUserByUsername (String username) throws 
UsernameNotFoundException ( 
User user - userRepository.findByUserName (username); 
if (user -- null)( 
throw new UsernameNotFoundException (" 用 户 不 存在 ! "); 
H 
List«SimpleGrantedAuthority» simpleGrantedAuthorities = new 
ArrayList«»(); 
for (Role role : user.getRoleList()) ( 
simpleGrantedAuthorities.add(new SimpleGrantedAuthority 
(role.getRoleName())); 
b 
return new org.springframework.security.core.userdetails.User 
(user.getUserName(), user.getPassWord(), simpleGrantedAuthorities); 
l 
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6. 页 面 及 Controller 


页 面 没有 什么 改变 ， 基 本 上 和 7.1 节 一 致 ， 读 者 可 以 查看 本 书 的 源 代 码 。 接 下 来 创建 一 个 
TestController 进行 页 面 跳 转 ， 如 代码 清单 7-22 所 示 。 


代码 清单 7-22 Spring Secu 


GController 
public class TestController ( 
GRequestMapping(("/","/index"]) 
public String index()( 
return"index"; 


i 


GRequestMapping ("/select") 
public String select (){ 
return "select"; 


h 


GRequestMapping ("/delete") 
public String delete (){ 
return "delete"; 


} 


@RequestMapping ("/login") 
public String login(){ 
return "login"; 


lj 


GRequestMapping("/login error") 

public String login error(Model model)( 
model.addattribute("login_error"，" 用 户 名 或 密码 错误 ") ; 
return "login"; 


) 


GRequestMapping ("/logout") 

public String logout (Model model) ( 
model.addAttribute("login error", "注销 成 功 "); 
return "login"; 

b 

GRequestMapping ("/401") 

public String error()( 
return "401"; 
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7. 测试 
推荐 的 测试 方式 与 7.1 节 大 致 一 致 ， 这 里 不 再 獒 述 。 


7.3 小 结 


本 章 学 习 了 Spring Boot 和 Apache Shiro 及 Spring Security 的 整合 ， 虽 然 整合 得 深度 不 高 ， 但 
是 已 经 将 二 者 结合 起 来 ， 可 以 在 接 下 来 的 工作 中 有 一 定 的 基础 。 同 时 ， 如 果 要 对 安全 框架 进行 扩展 
使 用 ， 也 可 以 在 本 书 的 基础 上 使 用 。 


Spring Boot 的 监控 之 旅 


监控 是 一 个 系统 长 期 运营 的 必要 保障 ， 我 们 可 以 做 一 个 这 样 的 假设 ， 当 马路 上 不 再 有 监控 设备 
时 ， 许 多 违章 违纪 的 车 辆 将 会 钼 法律 的 空子 ， 不 受 法 律 的 管理 ， 长 期 这 样 ， 交 通 秩序 将 不 再 得 到 保 
障 。 而 对 于 软件 系统 来 说 ， 监 控 同 样 必 不 可 少 ， 它 可 以 在 系统 出 现 问 题 的 时 候 自动 提示 系统 维护 人 
员 ， 可 以 使 出 现 的 问题 及 时 得 到 修复 。 本 章 笔 者 将 带领 大 家 学 习 Spring Boot 常用 的 监控 。 


8.1 使 用 actuator 监控 


8.1.1 actuator 是 什么 


在 Spring Boot 的 众多 Starter POMs 中 有 一 个 特殊 的 模块 ， 不 同 于 其 他 模块 大 多 用 于 开发 业务 
功能 或 连接 一 些 其 他 外 部 资源 ， 完 全 是 一 个 用 于 暴露 自身 信息 的 模块 ， 主 要 用 于 监控 与 管理 ， 它 就 
是 spring-boot-starter-actuator。 

spring-boot-starter-actuator 模块 的 实现 对 于 实施 微服 务 的 中 小 团队 来 说 ， 可 以 有 效 地 减少 监控 
系统 在 采集 应 用 指标 时 的 开发 量 。 当 然 , 它 并 不 是 万 能 的 ， 有 时 我 们 需要 对 其 做 一 些 简 单 的 扩展 来 
帮助 我 们 实现 自身 系统 个 性 化 的 监控 需求 。 下 面 将 详细 介绍 关于 spring-boot-starter-actuator 模块 的 
内 容 ， 包 括 它 原生 提供 的 端点 以 及 一 些 常用 的 扩展 和 配置 方式 。 


8.1.2 ”如 何 使 用 actuator 


在 Spring Boot 中 使 用 actuator 很 简单 , 只 需要 将 项 目 加 入 spring-boot-starter-actuator 依赖 即 可 。 
这 里 为 了 方便 观察 ， 也 加 入 了 spring-boot-starter-web 依赖 ， 如 代码 清单 8-1 所 示 。 
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代码 清单 8-1 Spring Boot-Actuator 项 目 依赖 文件 代码 


«dependencies» 
«dependency» 
XgroupId»org.springframework.boot«/groupId» 
XartifactId»spring-boot-starter-actuator«/artifactId» 
</dependency> 
<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 
</dependency> 
</dependencies> 


8.1.3 actuator 监控 介绍 


没有 特殊 需求 的 话 ， 其 实 到 这 里 已 经 配置 完成 了 ， 已 经 为 应 用 程序 开启 了 很 多 actuator 端点 。 
在 Spring Boot 应 用 中 内 置 了 很 多 端点 ， 当 然 也 支持 添加 自己 需要 的 端点 。 例 如 ，health 端点 就 提 
供 了 应 用 程序 的 健康 信息 。 

大 部 分 actuator 端点 都 是 可 以 独立 进行 的 , 通过 对 端点 的 启用 和 禁用 可 以 控制 是 否 创建 端点 用 
于 查看 信息 。Spring Boot 应 用 通过 JMX 或 者 HTTP 公开 端点 ， 大 多 数 应 用 程序 都 是 使 用 HTTP A 
露 端 点 的 ， 端 点 使 用 前 级 /actuator 加 上 端点 ID 来 访问 。 例 如 ， 在 默认 情况 下 ，health 端点 映射 到 
/actuator/health 。 

表 8-1 是 actuator 暴露 的 端点 。 


表 8-1 actuator 暴露 的 端点 


HTTP 方法 ID 描述 默认 情况 下 是 否 启用 
GET auditevents 显示 应 用 程序 的 审核 事件 信息 是 
GET beans 显示 应 用 程序 中 所 有 Spring Bean 的 完整 列表 是 
wa ow 显示 在 配置 和 自动 配置 类 上 评估 的 条 件 以 及 它们 是 
匹配 或 不 匹配 的 原因 
GET configprops 显示 配置 列表 ， 包 括 默认 配置 是 
GET env 显示 Spring 的 环境 变量 是 
GET flyway 显示 已 应 用 的 任何 Flyway 数据 库 迁 移 是 
GET health 查看 应 用 健康 信息 是 
GET httptrace 显示 HTTP 跟踪 信息 (默认 情况 下 显示 最 后 100 个 ) | 是 
. 获取 应 用 程序 定制 信息 , 这 些 信息 提供 info 打头 的 
GET info 是 
属性 
GET loggers 显示 和 修改 应 用 程序 中 记录 器 的 配置 是 
GET liquibase 显示 已 应 用 的 任何 Liquibase 数据 库 迁 移 是 
GET metrics 显示 当前 应 用 程序 的 “指标 ”信息 是 
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ER) 

HTTP 方 法 “| ID 描述 默认 情况 下 是 否 启用 
GET mappings 显示 所 有 @RequestMapping 路 径 的 整理 列表 是 
GET scheduledtasks | 显示 应 用 程序 中 的 计划 任务 是 

人 允许 从 Spring Session 支持 的 会 话 存储 中 检索 和 删 
GET sessions 除 用 户 会 话 。 注 : Spring Session 不 支持 Web 响应 | 是 

式 编程 
POST shutdown 允许 应 用 程序 正常 关闭 是 
GET threaddump 执行 线程 转 储 否 
GET heapdump 返回 GZip 压缩 hprof 堆 转 储 文件 是 
am STA 通过 HTTP 公开 JMX bean. (24 Jolokia 在 类 路 径 上 是 

时 ， 不 适用 于 WebFlux) 

返回 日 志文 件 的 内 容 (如果 已 设置 logging.file 或 
GET logfile logging.path 属性 )。 支 持 使 用 HTTP Range 标 头 来 | 否 

检索 部 分 日 志文 件 的 内 容 
GET prometheus 可 以 由 Prometheus 服务 器 抓 取 的 格式 公开 指标 是 


虽然 大 部 分 端点 在 默认 情况 下 都 是 启用 状态 ， 但 是 在 Spring Boot 应 用 中 ， 默 认 只 开启 info 端 
点 和 health 端点 。 其 余 端点 都 需要 通过 声明 属性 来 开启 ， 如 代码 清单 8-2 所 示 。 


代码 清单 8-2 ”开启 全 部 端点 相关 代码 


management.endpoints.web.exposure.include- * 


通过 以 上 设置 可 以 开启 所 有 默认 启用 的 端点 。 当 然 ， 我 们 也 可 以 根据 ID 指定 开启 端点 ， 如 代 
码 清单 8-3 所 示 。 


代码 清单 8-3 ”开启 局 部 端点 相关 代码 


management.endpoints.web.exposure.include- heapdump,env 


如 果 想 要 开启 shutdown 端点 ， 那 么 可 以 使 用 如 下 配置 使 shutdown 端点 生效 ， 如 代码 清单 8-4 
所 示 。 


代码 清单 8-4 ”开启 shutdown 端点 相关 代码 


management.endpoint.shutdown.enabled = true 


其 实 ， 在 Spring Boot 应 用 程序 中 ， 启 动 项 目 后 在 日 志 上 就 可 以 看 到 开启 的 Web 端点 ， 如 图 
8-1 所 示 。 
还 有 一 种 查看 方式 ， 就 是 通过 HTTP 请 求 访问 /actuator， 如 图 8-2 所 示 。 
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图 8-1 Spring Boot-Actuator 项 目 通过 启动 日 志 查看 actuator 端点 


8-2 Spring Boot-Actuator 项 目 通 过 HTTP 请 求 查看 actuator 端点 


8.1.4 保护 HTTP 端点 


Spring Boot 应 用 程序 提供 的 actuator 端点 虽然 为 我 们 提供 了 一 定 的 便利 ， 但 若 没 有 安全 限制 ， 
则 会 有 一 定 的 风险 ， 比 如 shutdown 端点 随意 暴露 的 话 ， 应 用 的 启 停 就 会 被 “坏人 ”利用 。 

这 时 我 们 可 以 像 使 用 任何 其 他 敏感 URL 一 样 注意 保护 HTTP 端点 。 若 存在 Spring Security, 
则 默认 使 用 Spring Security 的 内 容 协商 策略 来 保护 端点 。 例 如 ， 如 果 你 希望 为 HTTP 端点 配置 自 定 
义 安全 性 ， 只 允许 具有 特定 角色 的 用 户 访问 它们 ，Spring Boot 提供 了 一 些 RequestMatcher 可 以 与 
Spring Security 结合 使 用 的 便捷 对 象 。 

在 项 目 中 加 入 spring-boot-starter-security 依赖 ， 如 代码 清单 8-5 所 示 。 


代码 清单 8-5 Spring Boot-Actuator 项 目 新 增 依赖 代码 


«dependency» 
XgroupId»org.springframework.boot«/groupId» 
XartifactlId^»spring-boot-starter-security«/artifactlId» 
</dependency> 


当 在 应 用 程序 中 加 入 spring-boot-starter-security 依赖 后 , 再 次 在 浏览 器 中 访问 actuator 端点 时 ， 
页 面 如 图 8-3 所 示 。 

因为 我 们 没有 为 Spring Security 设置 用 户 密码 ， 所 以 暂时 无 法 登录 。 接 下 来 ， 在 配置 文件 中 为 
Spring Security 设置 一 个 安全 用 户 ， 如 代码 清单 8-6 所 示 。 


代码 清单 8-6 Spring Boot-Actuator 项 目 配置 Spring Security 安全 用 户 


spring.security.user.name-admin 
Spring.security.user.password-123456 
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图 8-3 Spring Boot-Actuator 项 目 通过 HTTP 请 求 登录 验证 


重启 项 目 ， 再 次 访问 actuator 端点 时 ， 输 入 正确 的 用 户 名 和 密码 即 可 正常 查看 actuator 端点 的 
信息 ， 与 图 8-2 中 的 内 容 一 样 。 

actuator 也 支持 如 7-2 小 节 那 样 ， 通 过 配置 权限 来 决定 哪些 方法 可 以 被 符合 权限 的 用 户 访问 ， 
新 增 ActuatorSecurity 配置 类 ， 继 承 WebSecurityConfigurerAdapter 并 且 重 写 了 configure() 方 法 ， 如 
代码 清单 8-7 所 示 。 


代码 清单 8-7 Spring Boot-Actuator 项 目 ActuatorSecurity 类 代码 


GConfiguration 
public class ActuatorSecurity extends WebSecurityConfigurerAdapter { 


GOverride 
protected void configure(HttpSecurity http) throws Exception { 
http.requestMatcher (EndpointRequest.toAnyEndpoint ()) . 
authorizeRequests() 
.anyRequest().hasRole("ENDPOINT ADMIN") 
.and() 
.httpBasic(); 


) 


在 ActuatorSecurity 配置 类 中 设置 任意 actuator 端点 可 以 被 安全 用 户 登 录 ， 但 是 安全 用 户 需 要 
具备 ENDPOINT ADMIN 权限 ， 如 果 安 全 用 户 没有 权限 ， 访 问 就 会 报 403 错误 (权限 不 足 ) du 
图 8-4 所 示 。 


Whitelabel Error Page 


[This application has no explicit mapping for /error, so you aro seeing this as a fallback. 


[Sat Dec 08 22:06:36 CST 2018 
| There was an unexpected error (type-Forbicden, status-403). 
Forbidden 


8-4 Spring Boot-Actuator 项 目 403 错误 页 面 
接 下 来 ， 在 配置 文件 中 为 安全 用 户 赋 予 ENDPOINT_ADMIN 权限 ， 如 代码 清单 8-8 所 示 。 


代码 清单 8-8 Spring Boot-Actuator 项 目 将 安全 用 户 赋予 权限 


spring.security.user.roles=ENDPOINT ADMIN 
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启 项 目 ， 再 次 访问 可 以 正常 查看 actuator 端点 信息 。 

当然 ， 我 们 也 可 以 设置 无 须 身份 验证 即 可 访问 所 有 执行 器 端点 。 将 ActuatorSecurity 配置 类 的 
@Configiration 注释 上 ， 其 实 就 是 取消 ActuatorSecurity 配置 ， 新 建 ActuatorNoSecurity 配置 类 。 这 
里 配置 所 有 用 户 可 以 访问 actuator 端点 ， 如 代码 清单 8-9 所 示 。 


代码 清单 8-9 Spring Boot-Actuator 项 目 无 须 安全 验证 配置 类 


GConfiguration 
public class ActuatorNoSecurity extends WebSecurityConfigurerAdapter ( 


GOverride 
protected void configure(HttpSecurity http) throws Exception ( 
http.requestMatcher (EndpointRequest.toAnyEndpoint () ) . 
authorizeRequests() 
.anyRequest () .permitAll(); 
b 


) 


重启 项 目 后 ， 即 使 加 入 了 Spring Security， 也 无 须 身 份 验证 就 可 以 访问 actuator 端点 。 


8.1.5 ”健康 信息 


health 端点 是 查看 Spring Boot 应 用 程序 健康 状况 的 端点 ， 如 果 没 有 特殊 设置 ， 显 示 的 信息 就 

比较 少 ， 如 下 所 示 : 
i"status";"Ub") 

我 们 可 以 通过 在 配置 文件 中 设置 management.endpoint.health.show-details 来 决定 health 端点 的 
细节 信息 是 否 展 示 。 以 下 为 health 端点 的 细节 属性 。 

* never; 细节 信息 详情 永远 都 不 展示 。 

* when-authorized: 细节 详情 只 对 授权 用 户 显示 。 

* always 细节 详情 显示 给 所 有 用 户 。 

属性 默认 值 为 never， 当 存在 授权 用 户 时 ， 如 果 一 个 用 户 处 于 一 个 或 者 多 个 端点 的 角色 ， 则 将 
被 视 为 已 经 获得 授权 。 如 果 端 点 没有 配置 角色 ， 则 认为 所 有 经 过 身份 验证 的 用 户 都 已 获得 授权 。 我 
们 可 以 使 用 management.endpoint.health.roles 属性 配置 角色 。 

这 里 以 always 为 例 ， 在 配置 文件 中 加 入 配置 ， 如 代码 清单 8-10 Bras. 


代码 清单 8-10 Spring Boot-Actuator 项 目 加 入 配置 


management.endpoint.health.show-details-always 


重启 项 目 ， 重 新 访问 http://localhost:8080/actuator/health， 这 时 健康 端点 信息 如 下 : 


("status":"UP","details":("diskSpace":("status":"UP","details":("total":2 
50790436864,"free":101807063040, "threshold":10485760]]]] 
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当然 ， 详 情 开 放 不 只 是 针对 health 端点 ， 其 他 端点 同样 适用 。 

在 这 个 测试 项 目 中 ， 可 能 看 不 到 health 端点 的 作用 ， 因 为 这 个 项 目 中 没有 配置 其 他 相关 的 信 
息 。 其 实 健康 信息 的 内 容 是 从 HealthIndicators 中 收集 应 用 程序 中 定义 的 所 有 bean 中 的 上 下 文 信息 ， 
其 中 包含 一 些 自动 配置 的 HealthIndicators， 也 可 以 编写 自己 的 健康 信息 bean。Spring Boot 默认 会 
自动 配置 以 下 HealthIndicators。 


CassandraHealthIndicator: 检查 Cassandra 数据 库 是 否 已 启动 。 
DiskSpaceHealthIndicator: 检查 磁盘 空间 是 否 不 足 。 
DataSourceHealthIndicator: 检查 是 否 可 以 获得 连接 的 DataSource。 
ElasticsearchHealthIndicator: 检查 Elasticsearch 集群 是 否 已 启动 。 
InfluxDbHealthIndicator: 检查 InfluxDB 服务 器 是 否 已 启动 。 
JmsHealthIndicator: 检查 JMS 代理 是 否 已 启动 。 
MailHealthIndicator: 检查 邮件 服务 器 是 否 已 启动 。 
MongoHealthIndicator: 检查 Mongo 数据 库 是 否 已 启动 。 
Neo4jHealthIndicator: 检查 Neo4j 数据 库 是 否 已 启动 。 
RabbitHealthIndicator: 检查 Rabbit 服务 器 是 否 已 启动 。 
RedisHealthIndicator: 检查 Redis 服务 器 是 否 已 启动 。 
SolrHealthIndicator: 检查 Solr 服务 器 是 否 已 启动 。 


如 果 不 想 在 项 目 中 使 用 这 些 安全 检查 ， 就 可 以 使 用 management.health.defaults.enabled 属性 来 
禁用 它们 ， 比 如 要 禁用 Rabbit 安全 检查 ， 可 以 做 如 下 设置 ， 如 代码 清单 8-11 所 示 。 


代码 清单 8-11 Spring Boot-Actuator 项 目 禁 用 Rabbit 服务 器 安全 检查 


management.health.rabbit.enabled-false 


之 前 提 到 了 自 定义 HealthIndicators, 接 下 来 带领 大 家 编写 一 个 自 定义 的 HealthIndicators。 其 实 
要 提供 自 定义 健康 状况 信息 ， 只 需要 编写 一 个 实现 HealthIndicator 的 类 ， 重 写 health 方法 即 可 。 这 
里 编写 一 个 简单 的 自 定义 HealthIndicators， 如 代码 清单 8-12 所 示 。 


代码 清单 8-12 Spring Boot-Actuator 项 目 自 定义 Healthlndicators 


import org.springframework.boot.actuate.health.Health; 
import org.springframework.boot.actuate.health.HealthIndicator; 
import org.springframework.stereotype.Component; 


GComponent 
public class MyHealthIndicator implements HealthIndicator ( 


private final String defaultServerPort - "80"; 


GValue("$(server.port])") 
private String serverPort; 


GOverride 
public Health health() ( 
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int errorCode = check(); 
if (errorCode !- 0) ( 
return Health.down().withDetail("Error Code:", errorCode) .build(); 
p 
return Health.up().build(); 
) 


public int check()( 
if(!defaultServerPort.equals (serverPort))( 
return 500; 
$ 


return 0; 


) 


TE MyHealthIndicator 类 中 ， 其 实 只 是 做 了 一 个 检查 ， 这 里 设置 了 一 个 默认 的 端口 号 。 如 果 当 
前 应 用 程序 端口 号 不 是 默认 端口 号 〈80) ， 就 返回 错误 码 500; 如 果 当 前 应 用 程序 端口 号 为 8080， 
就 启动 项 目 ， 访 问 http://localhost:8080/actuator/health， 如 下 所 示 : 
("status":"DOWN","details":("my":("status":"DOWN","details":("Error 
Code:":500)), "diskSpace": ("status":"UP", "details":("total":250790436864,"free 
":101805297664, "threshold":10485760]]]) 


在 输出 信息 中 可 以 看 到 我 们 自 定 义 的 信息 已 经 打印 出 来 了 。 


8.1.6 自 定义 应 用 程序 信息 


在 actuator 端点 中 可 以 公开 自 定义 信息 , 比如 在 配置 文件 中 设置 info.*, 如 代码 清单 8-13 所 示 。 


代码 清单 8-13 Spring Boot-Actuator 项 目 自 定义 info 属性 暴露 


info.encoding = UTF-8 
info.jdk.version - 1.8 


重启 项 目 ， 访 问 http://localhost:8080/actuator/info 后 即 可 看 到 ， 这 里 不 再 展示 。 


8.1.7. 自 定义 管理 端点 路 径 


之 前 介绍 了 ，actuator 端点 在 使 用 HTTP 访问 时 需要 使 用 前 级 /actuator， 其 实 这 个 前 缀 也 可 以 
根据 需求 自 定义 修改 ， 只 需要 在 配置 文件 中 配置 management.endpoints.web.base-path 属性 即 可 ， 如 
代码 清单 8-14 所 示 。 


代码 清单 8-14 Spring Boot-Actuator 项目 自 定义 管理 端点 路 径 


management.endpoints.web.base-path-/manage 
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修改 后 ， 再 访问 health 端点 ， 就 由 /actuator/health 变 成 了 /manage/health。 

actuator 是 Spring Boot 的 重要 特性 ， 关 于 actuator 的 内 容 还 有 很 多 ， 提 供 端点 能 够 做 到 的 监控 
也 有 很 多 ， 有 具体 可 以 查看 官网 对 于 actuator 端点 的 介绍 (Spring Boot 2.0.3 版 本 的 官网 地 址 : 
https://docs.spring.io/spring-boot/docs/2.0.3.RELEASE/actuator-api//html/) 。 


8.2 使 用 Admin 监控 


8.2.1 什么 是 Spring Boot Admin 


Spring Boot Admin 是 Spring Boot 项 目的 一 个 社区 项 目 , 主要 用 于 管理 和 监控 Spring Boot 应 用 
程序 。 通 常 来 说 ， 应 用 程序 向 我 们 的 Spring Boot Admin Server (通过 HTTP) 直接 注册 信息 或 者 
Spring Boot Admin Server 通过 使 用 Spring Cloud (例如 Eureka、Consul) 服务 发 现 收集 Client 信息 。 
UI 只 是 Spring Boot Actuator 端点 上 的 一 个 AngularJs 应 用 程序 (2.x 版 本 后 使 用 Vue) o 


8.22 设置 Spring Boot Admin Server 


Spring Boot Admin 应 用 分 为 Spring Boot Admin Server 应 用 和 Spring Boot Admin Client 应 用 。 
其 中 ，Spring Boot Admin Server 应 用 用 于 收集 Spring Boot Admin Client 应 用 的 信息 并 对 其 进行 监 
控 等 。 接 下 来 ， 我 们 创建 一 个 Spring Boot Admin Server 应 用 。 

创建 Spring Boot Admin Server 应 用 的 过 程 大 致 分 为 两 步 ,首先 创建 一 个 Spring Boot 应 用 程序 ， 
在 pom 文件 中 加 入 依赖 ， 如 代码 清单 8-15 Bras. 


代码 清单 8-15 Spring Boot-Admin-Server 项 目 依赖 文件 代码 


<dependency> 
XgroupId»org.springframework.boot«/groupId» 
XartifactId»spring-boot-starter-web«/artifactId» 
«/dependency» 
«dependency» 
XgroupId»de.codecentric«/groupId» 
X«artifactlId»spring-boot-admin-starter-serverc«/artifactlId» 


</dependency> 


然后 在 Spring Boot 应 用 程序 启动 类 中 加 入 @EnableAdminServer， 引 入 Spring Boot Admin 
Server 配置 ， 如 代码 清单 8-16 所 示 。 


代码 清单 8-16 Spring Boot-Admin-Server 项 目 依赖 文件 代码 


@Spring BootApplication 
QEnableAdminServer 
public class Chapter83Application ( 
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public static void main(String[] args) ( 
SpringApplication.run(Chapter83Application.class, args); 
} 
3 


到 这 里 , Spring Boot-Admin-Server 项 目 就 已 经 配置 完成 了 。 启动 项 目 可 以 看 到 如 图 8-5 所 示 的 页 面 。 


参 Spring Boot Admin 


8-5 Spring Boot-Admin-Server 监控 页 面 


由 于 还 没有 Spring Boot Admin Client 应 用 注册 到 Spring Boot-Admin-Server， 因 此 现在 实例 数 
量 还 是 0。 


8.2.3 Spring Cloud Eureka 


可 能 到 这 里 有 人 会 问 ， 这 是 一 本 讲解 Spring Boot 的 书 ， 为 什么 突然 讲 到 Spring Cloud 的 组 件 
Eureka。 因 为 Spring Boot Admin Client 有 一 种 方式 是 基于 Eureka 获取 信息 ， 所 以 这 里 介绍 一 下 
Spring Cloud 的 注册 中 心 组件 Eureka。 

引用 官方 的 介绍 : Eureka 是 Netflix 开发 的 服务 发 现 框架 ， 本 身 是 一 个 基于 REST 的 服务 ， 主 
要 用 于 定位 运行 在 AWS 域 中 的 中 间 层 服务 , 以 达到 负载 均衡 和 中 间 层 服务 故障 转移 的 目的 .Spring 
Cloud 将 它 集 成 在 子 项 目 spring-cloud-netflix 中 ， 以 实现 Spring Cloud 的 服务 发 现 功能 。 

通俗 地 理解 ，Eureka 就 是 一 个 注册 中 心 。 本 小 节 仅 对 Eureka Server 进行 简单 的 介绍 ， 感 兴趣 
的 读者 可 以 去 Spring Cloud 官网 (官网 地 址 : https://cloud.spring.io/spring-cloud-static/Finchley.SR2/ 
single/spring-cloud.html) 查看 更 多 关于 Eureka 的 信息 。 

接 下 来 ， 笔 者 带领 大 家 创建 一 个 Eureka Server。 新 建 项 目 ， 在 pom 文件 中 加 入 spring-cloud- 
starter-netflix-eureka-server 依赖 (使 用 Spring Cloud Finchley.SR1 版 本 ) 。 完 整 pom 文件 内 容 如 代 
码 清单 8-17 所 示 。 


代码 清单 8-17 Spring Cloud-Eureka-Server 项 目 依赖 文件 代码 


<?xml version-"1.0" encoding-"UTF-8"?» 
«project xmlns-"http://maven.apache.org/POM/4.0.0" xmlns:xsi- 
"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/xsd/maven-4.0.0.xsd"» 
«modelVersion?»4.0.0«/modelVersion» 
«parent» 
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XgroupId»org.springframework.boot«/groupId» 
XartifactId»spring-boot-starter-parent«/artifactId» 
«version»2.0.3.RELEASE«/version» 
XrelativePath/» «!-- lookup parent from repository --> 
X/parent» 
XgroupId»com.springboot«/groupId» 
XartifactId»chapter8-2«/artifactId» 
«version»0.0.1-SNAPSHOT«/version» 
Xpackaging»jar«/packaging» 
«name»chapter8-2«/name» 
Xdescription»chapter8-2«/description» 


«properties» 
«java.version»1.8«/java.version» 
Xspring-cloud.version»Finchley.SR1«/spring-cloud.version» 
«/properties» 


«dependencies» 
<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter-netflix-eureka-server 
</artifactId> 
</dependency> 


<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-test</artifactId> 
<scope>test</scope> 
</dependency> 
</dependencies> 


<dependencyManagement> 
<dependencies> 
<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-dependencies</artifactId> 
<version>${spring-cloud.version}</version> 
<type>pom</type> 
<scope>import</scope> 
</dependency> 
</dependencies> 
</dependencyManagement> 


<build> 
<plugins> 
<plugin> 
XgroupId»org.springframework.boot«/groupId» 
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<artifactId>spring-boot-maven-plugin</artifactId> 
</plugin> 
</plugins> 
</build> 


<repositories> 
<repository> 
<id>spring-milestones</id> 
<name>Spring Milestones</name> 
<url>https://repo.spring.io/milestone</url> 
<snapshots> 
<enabled>false</enabled> 
</snapshots> 
</repository> 
</repositories> 


</project> 


然后 在 启动 类 中 加 入 注解 @EnableEurekaServer， 表 明 当 前 Spring Boot 应 用 程序 是 一 个 Eureka 
Server 程序 ， 如 代码 清单 8-18 所 示 。 


代码 清单 8-18 Spring Cloud-Eureka-Server 项 目 启动 类 代码 


GSpringBootApplication 
QEnableEurekaServer 
public class Chapter82Application ( 


public static void main(String[] args) ( 
SpringApplication.run(Chapter82Application.class, args); 


) 


最 后 ， 我 们 只 需要 在 配置 文件 中 对 Eureka Server 应 用 程序 进行 配置 ， 因 为 这 里 使 用 单 节点 
Eureka Server 应 用 ， 注 意 设置 禁止 向 自己 注册 服务 。 配 置 文件 如 代码 清单 8-19 所 示 。 


代码 清单 8-19 Spring Cloud-Eureka-Server 配置 文件 代码 


server.port-8761 

eureka.instance.hostname-localhost 

eureka.client.service-url.defaultZone-http://$(eureka.instance.hostname): 
$(server.port)/eureka/ 


## 禁 止 向 自己 注册 
eureka.client.register-with-eureka-false 
eureka.client.fetch-registry-false 
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到 这 里 ，Eureka Server 应 用 配置 完成 了 。 启 动 项 目 ， 在 浏览 器 中 访问 http://localhost:8761， 可 
以 看 到 如 图 8-6 所 示 的 页 面 。 


©) spring HOME LAsT1000 SINCESTARTUP 


System Status 
Environment ve Current time 2018-12-09T15.57.02 +0800 
Data center pm Uptime 0000 
Lease expiration enabied taise 
Renews threshold 1 
Renews last min) o 
DS Replicas 


Instances currently registered with Eureka 


No Instances available 


General Info 
Name Value 


total-avail-memory 360mb 


图 8-6 Spring Boot-Eureka Server 监控 页 面 


与 Spring Boot Admin Server 一 致 ， 目 前 还 没有 实例 注册 进来 ， 所 以 现在 实例 是 空 的 ， 稍 后 会 
继续 使 用 。 


8.24 Spring Boot Admin Client 的 使 用 


前 面 介绍 了 , 使 用 Spring Boot Admin Server 监控 管理 有 两 种 方式 , 基于 Spring Cloud Discovery 
(Eureka 服务 发 现 ) 或 者 对 实例 应 用 进行 配置 。 接 下 来 笔者 带领 大 家 分 别 对 两 种 模式 进行 学 习 。 
1. Spring Boot Admin 客户 端 


使 用 这 种 方式 ， 所 有 需要 使 用 Spring Boot Admin Server 监控 管理 的 应 用 程序 都 需要 引入 
spring-boot-admin-starter-client 依赖 ， 如 代码 清单 8-20 所 示 。 


代码 清单 8-20 Spring Boot Admin Client 项 目 依赖 文件 代码 


«dependency» 
XgroupId»org.springframework.boot«/groupId» 
X«artifactlId^spring-boot-starter-web«/artifactId» 
«/dependency» 
«dependency» 
XgroupId»de.codecentric«/groupId» 
XartifactlId^spring-boot-admin-starter-client«/artifactId» 
«version»2.0.3«/version» 


</dependency> 
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接 下 来 ,在 配置 文件 中 配置 Spring Boot Admin Server 的 地 址 , 并 且 配 置 应 用 名 称 , 以 便 在 Spring 
Boot Admin Server 页 面 查看 。 这 里 将 端口 号 设置 为 8081， 如 代码 清单 8-21 所 示 。 


代码 清单 8-21 Spring Boot Admin Client 项 目 依 赖 文件 代码 


spring.boot.admin.client.url-http://localhost:8080 
server.port-8081 
spring.application.name-springboot-admin-client 


启动 Spring Boot Admin Client 应 用 程序 后 , 再 来 查看 一 下 Spring Boot Admin Server 监控 页 面 ， 
如 图 8-7 所 示 。 


Ø Spring Boot Admin 


图 8-7 Spring Boot-Admin Server 监控 页 面 


从 图 8-7 中 可 以 看 到 我 们 刚刚 创建 的 应 用 实例 已 经 注册 到 了 Spring Boot Admin Server 中 ， 在 
Spring Boot Admin Server 中 会 检测 Spring Boot Admin Client 实例 的 健康 状况 ， 其 实 就 是 检测 
actuator 端点 的 health 端点 ， 因 为 当前 应 用 实例 状态 为 up， 所 以 状态 显示 为 all up。 如 果 当 前 有 任 
何 应 用 不 是 up 状态 ， 就 会 显示 状态 为 down。 

接 下 来 单 击 实例 ， 可 以 查看 实例 的 详细 信息 ， 如 图 8-8 Pra. 


49 Spring Boot Admin 


springboot-admin-client 
Id: 1d33cdaaffda 
LE LI ia LL = /nc * di h 
Info Health 
Instance up 
Metadata 
Startup  2018-12-09716:14:43979408:00 


8-8 实例 的 详细 信息 


由 于 当前 Spring Boot Admin Client 应 用 程序 没有 为 actuator 开放 更 多 的 端点 , 因此 这 里 仅 能 看 
到 很 少 的 信息 。 接 下 来 我 们 为 当前 应 用 程序 开放 全 部 端点 并 且 设 置 显示 全 部 详细 信息 ， 然 后 查看 
Spring Boot Admin Server 监控 页 面 ， 如 图 8-9 所 示 。 
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从 图 8-9 中 可 以 看 到 Spring Boot-Admin Server 监控 页 面 的 数据 随 着 开放 的 端点 变 多 而 变 多 ， 其 
实 Spring Boot-Admin Server 监控 就 是 对 Spring Boot 应 用 程序 的 actuator 端点 进行 一 定 的 监控 管理 。 


89 Spring Boot Admin 


springboot-admin-client 


Insights 


Metrics 
Info Health 


Instance je 


diskSpace Jp 
Scheduled Tasks 
Metadata total 25168 
ogging 
free 10168 
MM startup 2018-12-09T16:4114.582«08.00 
threshold 105 MB 


图 8-9 再 次 查看 Spring Boot-Admin Server 监控 页 面 


2. 基于 服务 发 现 


接 下 来 ， 我 们 使 用 Eureka 的 方式 使 用 Spring Boot-Admin Server 监控 管理 。 新 建 项 目 ， 在 项 目 
中 加 入 spring-cloud-starter-netflix-eureka-client 依赖 ， 如 代码 清单 8-22 所 示 。 


2 Spring Boot Eureka Client 项 目 依 赖 文件 完整 代码 


<?xml version-"1.0" encoding-"UTF-8"?» 
<project xmlns-"http://maven.apache.org/POM/4.0.0" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/xsd/maven-4.0.0.xsd"» 
«modelVersion»4.0.0«/modelVersion» 
«parent» 
XgroupId»org.springframework.boot«/groupId» 
X«artifactld»spring-boot-starter-parent«/artifactld» 
«version»2.0.3.RELEASE«/version» 
XrelativePath/» «!-- lookup parent from repository --» 
X/parent» 
XgroupId»com.springboot«/groupId» 
XartifactId»chapter8-5«/artifactlId» 
«version»0.0.1-SNAPSHOT«/version» 
Xpackaging»jar«/packaging» 
«name»chapter8-5«/name» 
Xdescription»chapter8-5«/description» 


«properties» 


«java.version»1.8«/java.version» 


200 | Spring Boot 2 实战 之 旅 


</Properties> 


<dependencies> 
<dependency> 
XgroupId»org.springframework.boot«/groupId» 
XartifactId»spring-boot-starter«/artifactId» 
</dependency> 


<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-test</artifactId> 
<scope>test</scope> 

</dependency> 

<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 

</dependency> 

<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-actuator</artifactId> 

</dependency> 

<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter-netflix-eureka-client 

</artifactId> 
</dependency> 
</dependencies> 


<dependencyManagement> 
<dependencies> 
<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-dependencies</artifactId> 
<version>Finchley.SR1</version> 
<type>pom</type> 
<scope>import</scope> 
</dependency> 
</dependencies> 
</dependencyManagement> 


<build> 
<plugins> 
<plugin> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-maven-plugin</artifactId> 
</plugin> 
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</plugins> 
</build> 


<repositories> 
<repository> 
<id>spring-milestones</id> 
<name>Spring Milestones</name> 
<url>https://repo.spring.io/milestone</url> 
<snapshots> 
<enabled>false</enabled> 
</snapshots> 
</repository> 
</repositories> 


</project> 


在 配置 文件 中 配置 Eureka Server 的 地 址 ， 并 且 开 启 全 部 actuator 端点 ， 设 置 端口 号 为 8082， 
如 代码 清单 8-23 所 示 。 


代码 清单 8-23 Spring Boot Admin Client 项 目 依赖 文件 代码 


server.port-8082 
spring.application.name-springboot-admin-client2 
management.endpoints.web.exposure.include-* 
management.endpoint.health.show-details-always 

## eureka server 地 址 
eureka.client.service-url.defaultZone-http://localhost:8761/eureka/ 


然后 将 Spring Boot Admin Server 应 用 程序 加 入 Eureka Client 依赖 及 配置 ， 过 程 同 上 。 全 部 配 
置 完成 后 重启 项 目 ， 先 查看 一 下 Eureka Server 监控 页 面 ， 如 图 8-10 所 示 。 


©) spring 


System Status 


poo 2018-12.09717:23.56 «0800 


0001 


Environment te 


Data center defaut Uptrme 


Tease espration enabled Taise 
Renews iveshold B 


Renews (ast min) 2 


DS Replicas 


Instances currently registered with Eureka 


SPRINGBOOT-ADMIN-CUENTZ 


SPRINGBOOT-ADMIN-SERVER wan w 


L General info 


8-10 Spring Boot-Eureka Server 监控 页 面 


可 以 看 到 实例 部 分 已 经 存在 两 个 使 用 Eureka 的 应 用 实例 。 接 着 查看 Spring Boot Admin Server 
监控 页 面 ， 如 图 8-11 所 示 。 
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9 Spring Boot Admin 


SPRINGBOOT- | SPRINGBOOT- springboot- 


ADMIN-CLIENT2 ADMIN-SERVER | admin-client 


8-11 Spring Boot-Admin Server 监控 页 面 
笔者 分 别 介 绍 了 使 用 Spring Boot Admin 客户 端 和 基于 服务 发 现 两 种 方式 进行 注册 实例 ， 都 可 
以 达到 使 用 Spring Boot Admin 监控 的 目的 ， 这 里 笔者 建议 使 用 基于 Eureka 的 方式 ， 这 样 会 更 简单 
一 些 ， 无 须 基于 每 个 应 用 频繁 地 配置 。 


8.2.5 ”安全 验证 


如 果 Spring Boot Admin Server 监控 页 面 可 以 随意 查看 ， 似 乎 不 太 安全 。 接 下 来 笔者 带领 大 家 
为 Spring Boot Admin Server 监控 增加 安全 管理 , 在 pom 文件 中 加 入 spring-boot-starter-security 依赖 
配置 ， 如 代码 清单 8-24 所 示 。 


代码 清单 8-24 ”Spring Boot Admin Server 添加 Security 依赖 


<dependency> 
XgroupId»org.springframework.boot«/groupId» 
X«artifactId»spring-boot-starter-security«/artifactId» 
«/dependency» 


接 下 来 加 入 一 个 配置 类 ， 使 actuator 端点 可 访问 (这 里 设置 登录 用 户 可 以 查看 全 部 端点 ) ， 如 
代码 清单 8-25 所 示 。 


代码 清单 8-25 Spring Boot Admin Server 添加 SecurityPermitAllConfig 配置 代码 


@Configuration 
Public class SecurityPermitAllConfig extends WebSecurityConfigurerAdapter { 
GOverride 
protected void configure(HttpSecurity http) throws Exception ( 
http.authorizeRequests ().anyRequest () .permitAll() 
.and().csrf().disable(); 


) 


在 配置 文件 中 配置 用 户 名 admin, 13 123456, 然后 重启 项 目 , 访问 http://localhost:8080, Spring 
Boot Admin Server 为 我 们 提供 了 友好 的 登录 页 面 ， 如 图 8-12 所 示 。 
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全 


Spring Boot Admin 


图 8-12 Spring Boot-Eureka Server 监控 登录 页 面 
使 用 用 户 名 、 密 码 登录 后 ， 就 可 以 和 之 前 一 样 查看 Spring Boot Admin Server 安全 管理 页 面 。 


8.26 JMX-bean 管理 


如 果 在 Spring Boot Admin Server 安全 管理 页 面 需要 与 JMX-bean 交互 ， 那 么 在 应 用 程序 中 必 
须 包含 Jolokia。 由 于 Jolokia 是 基于 servlet 的 ， 因 此 不 支持 响应 式 应 用 程序 ，WebFlux 在 这 里 暂时 
不 支持 。 使 用 Jolokia 只 需要 引入 Jolokia 依赖 ， 如 代码 清单 8-26。 


代码 清单 8-26 Jolokia 依赖 代码 


<dependency> 
<groupId>org.jolokia</groupId> 
<artifactId>jolokia-core</artifactId> 
</dependency> 


8.2.7 ”通知 


Spring Boot Admin Server 不 但 提供 了 管理 页 面 供 我 们 查看 ， 而 且 提供 了 一 些 通知 ， 比 如 邮件 
通知 、PagerDuty 通知 、OpsGenie 通知 等 。 本 小 节 仅 对 邮件 通知 进行 介绍 。 

邮件 通知 将 作为 使 用 Thymeleaf 模板 呈现 的 HTML 电子 邮件 传递 。 如 果 需 要 启用 邮件 通知 ， 
就 需要 在 项 目 中 加 入 spring-boot-starter-mail 依赖 ， 如 代码 清单 8-27 所 示 。 


代码 清单 8-27 spring-boot-starter-mail 依赖 代码 


«dependency» 
XgroupId»org.springframework.boot«/groupId» 
XartifactlId^spring-boot-starter-mail«/artifactId» 

</dependency> 


在 配置 文件 中 新 增 邮箱 相关 配置 信息 , 在 后 面 的 章节 会 介绍 Spring Boot 邮件 发 送 的 相关 内 容 ， 
这 里 不 做 过 多 解释 。 关 于 Spirng Boot Admin 需要 设置 发 送 邮件 地 址 和 收 件 地 址 ， 如 代码 清单 8-28 
所 示 。 
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青 单 8-28 Spring Boot Admin Server 项 目 新 增 邮箱 发 送 模板 代码 


spring.mail.host-smtp.qq.com 
spring.mail.username-yangyang8dalaoyang.cn 
spring.mail.password= 邮 件 密码 
spring.mail.properties.mail.smtp.auth-true 
spring.mail.properties.mail.smtp.starttls.enable-true 
spring.mail.properties.mail.smtp.starttls.required-true 
spring.boot.admin.notify.mail.from-yangyang8dalaoyang.cn 
spring.boot.admin.notify.mail.to-yangyang8dalaoyang.cn 


重启 项 目 后 查看 邮件 ， 可 以 看 到 如 图 8-13 所 示 的 页 面 。 


SPRINGBOOT-ADMIN-SERVER (3d5fef315359) is OFFLINE 
yangyang X: & Vangyang 2018/12/9 18:20 详细 信息 


SPRINGBOOT-ADMIN-SERVER (3d5fef315359) is OFFLINE 
Instance 3d5fef315359 changed status from UP to OFFLINE 
Status Details 
exception 
lo.netty.handler.timeout.ReadTimeoutException 


message 


Registration 


Service Url. http://192.168.3.32:8080/ 
Health Url http://192.168.3.32:8080/actuator/health 
Management Url http://192.168.3.32:8080/actuator 


图 8-13 Spring Boot-Eureka Server 监控 邮件 发 送 


从 图 8-13 中 可 以 看 到 关于 实例 应 用 的 状态 变化 、 异 常 信息 等 ， 但 是 模板 是 英文 的 ， 如 果 需 要 
自 定义 页 面 模板 ， 那 么 可 以 新 建 一 个 HTML， 并 且 在 配置 文件 中 配置 spring.boot.admin.notify. 
mail.template。 比 如 在 src/main/resources/ 文 件 夹 下 创建 status-changed.html 文件 , 然后 在 配置 文件 中 
配置 spring.boot.admin.notify.mail.template=classpath:/status-changed.html。 以 下 是 笔者 根据 官方 提供 
的 模板 页 面 稍 作 修改 的 中 文 版 ， 如 代码 清单 8-29 所 示 。 


代码 清单 8-29 Spring Boot Admin Server 项 目 新 增 邮箱 相关 配置 代码 


<!DOCTYPE html» 
<html xmlns:th-"http://www.thymeleaf.org"» 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/> 
<style> 
hi, h2, h3, h4, h5, h6 t 


font-weight: 400 
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ul { 
list-style: none 


html { 


box-sizing: border-box 


*, :after, :before { 


box-sizing: inherit 


table { 
border-collapse: collapse; 
border-spacing: 0 


td, th ( 
text-align: left 


body, button ( 
font-family: BlinkMacSystemFont, -apple-system, "Segoe UI", 
Roboto, Oxygen, Ubuntu, Cantarell, "Fira Sans", "Droid Sans", "Helvetica Neue", 
Helvetica, Arial, sans-serif 


} 


code, pre { 
-moz-osx-font-smoothing: auto; 
-webkit-font-smoothing: auto; 
font-family: monospace 
) 
</style> 
</head> 
<body> 
<th:block th:remove-"all"» 
<!-- This block will not appear in the body and is used for the subject 
--» 


«th:block th:remove-"tag" th:fragment-"subject"» 


服务 提醒 : [[Stinstance.registration.name)]] (实例 
ID:[[($(instance.id])]]) 状态 变 成 了 
[[${event.statusInfo.status}]] 
</th:block> 
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th: 


th: 


th: 


«/th:block» 
<h1> 服 务 名 :<span th:text-"$[instance.registration.name)"/» (实例 ID:<span 
text="${instance.id}"/>) 
状态 变 成 了 
[[${event.statusInfo.status}]] 
</h1> 
<p> 
实例 <a th:if="${baseUrl}" th:href="@{${baseUrl + '/#/instances/' + 


instance.id + '/'}}"><span 


th:text="${instance.id}"/></a> 
<span th:unless="${baseUrl}" th:text="${instance.id}"/> 
状态 由 <span th:text="${lastStatus}"/> 变 为 «span 
text="${event.statusInfo.status}"/> 
</p> 


<h2> 状 态 细节 </h2> 
«dl th:fragment-"statusDetails" th:with-"details = $(details ?: 


event.statusInfo.details)"» 


Xth:block th:each-"detail : $(details)"» 
«dt th:text-"$(detail.key])"/» 
«dd th:unless-"$(detail.value instanceof T(java.util.Map)]" 
text-"$(detail.value)"/» 
«dd th:if-"$(detail.value instanceof T(java.util.Map)])"» 
«dl th:replace-"$(fexecInfo.templateName] :: statusDetails 


(details = $(detail.value))"/» 


«/dd» 
«/th:block» 
</dl> 


<h2> 注 册 信息 </h2> 
«table» 
«tr th:if-"$(instance.registration.serviceUrl)"» 
<td> 服 务 地 址 </td> 
<td> 
<a th:href-"$(instance.registration.serviceUrl)" 


th:text-"$(instance.registration.serviceUrl)"»«/a» 


«/td» 

«/tr» 

«tr» 
<td> 健 康 地 址 </td> 
<td> 


<a th:href-"$(instance.registration.healthUrl)" 


th:text-"$(instance.registration.healthUrl)"»«/a» 


«/td» 
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</table> 
</body> 
</html> 


«tr th:if-"S(instance.registration.managementUrl]"» 
<td> 管 理 地 址 </td> 
<td> 


<a th:href-"$(instance.registration.managementUrl]" 


th:text-"$([instance.registration.managementUrl)"»«/a» 
</td> 


使 用 自 定义 模板 后 ， 页 面 如 图 8-14 所 示 。 


服务 提醒 : SPRINGBOOT-ADMIN-CLIENT2 (实例 ID:f9610f329e7a) 状态 变 成 了 OFFLINE 
yangyang yangyang 2016/12/9 18.34 AMA 


服务 名 :SPRINGBOOT-ADMIN-CLIENT2 (实例 ID:f9610f329e7a) 状态 变 成 了 
OFFLINE 


实例 19610f329e7a 状态 由 UP S OFFLINE 


状态 细节 


exception. 

io.netty.channel.AbstractChannel SAnnotatedConnectException. 
message 

Connection refused: /192.168.3.32:8082 


注册 信息 


服务 地 址 http://192.168.3.32:8082/ 
健康 地 址 http://192.168.3.32:8082/actuator/health 
管理 地 址 http://192.168.3.32:8082Jactuator 


图 8-14 Spring Boot-Eureka Server 监控 邮件 发 送 


笔者 只 是 将 对 应 英文 修改 成 了 中 文 ， 没 有 做 过 多 修改 ， 具 体 使 用 可 以 仔细 考量 需要 得 到 的 


8.3 Prometheus-*Grafana 监控 


前 面 介绍 了 Spring Boot Admin 监控 Spring Boot 应 用 程序 ， 接 下 来 将 介绍 由 Prometheus 结合 
Grafana 搭建 Spring Boot 监控 平台 。 


8.3.1 


Prometheus 的 安装 


Prometheus《〈 官 网 地 址 : https://prometheus.io/) 是 一 个 开源 的 系统 监控 和 报警 的 工具 包 ， 最 初 
由 SoundCloud 发 布 .Prometheus 通过 在 这 些 目 标 上 抓 取 指 标 HTTP 端点 来 收集 受 监控 目标 的 指标 。 
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由 于 Prometheus 以 同样 的 方式 公开 数据 ， 因 此 它 也 可 以 掠夺 和 监控 自身 的 健康 状况 ， 感 兴趣 的 读 
者 可 以 查阅 官方 文档 。 

以 Linux 系统 为 例 进 行 介绍 , 到 Prometheus 官方 下 载 页 (官网 下 载 页 地 址 : https://prometheus.io/ 
download/) 下 载 安装 包 ， 如 代码 清单 8-30 所 示 。 


代码 清单 8-30 ”下载 Prometheus 代码 


wget https://github.com/prometheus/prometheus/releases/download/v2.6.1/ 
prometheus-2.6.1.1inux-amd64.tar.gz 


下 载 完 成 后 ， 解 压 文件 ， 如 代码 清单 8-31 所 示 。 
代码 清单 8-31 解压 Prometheus 代码 


tar xvfz prometheus-*.tar.gz 


8.3.2 Grafana 的 安装 


Grafana〔 官 网 地 址 ， https://grafana.com/). 是 一 个 深度 分 析 的 可 视 化 工具 ， 可 以 将 采集 的 数据 
进行 可 视 化 的 展示 。 如 图 8-15 所 示 是 Grafana 官网 首页 , 可 以 看 出 Grafana 是 做 图 形 化 分 析 的 工具 。 


rr 


nmm 


19 Grafana Labs 


The platform for 
analytics and monitoring 


The leading software for time series analytics 


图 8-15 Grafana 官网 首页 


可 以 在 Grafana 官网 下 载 页 (官网 下 载 页 地 址 : https://grafana.com/grafana/download) 下 载 
Grafana， 里 面 详细 介绍 了 各 个 操作 系统 如 何 安装 ， 这 里 不 再 袭 述 。 


8.3.3 Spring Boot 项 目 使 用 Prometheus 


新 建 项 目 ， 在 项 目 中 加 入 micrometer-registry-prometheus 依赖 ， 并 且 需 要 开启 actuator 端点 ， 
依赖 文件 如 代码 清单 8-32 所 示 。 
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代码 清单 8-32 Prometheus 依赖 代码 


<dependency> 
<groupId>org.springframework.boot</groupId> 
XartifactlId^spring-boot-starter-web«/artifactId» 
</dependency> 
<dependency> 
XgroupId»io.micrometer«/groupId» 
XartifactId»micrometer-registry-prometheus«/artifactId» 
«/dependency» 


在 配置 文件 中 加 入 配置 应 用 名 ， 并 且 开启 全 部 actuator 端点 ， 如 代码 清单 8-33 所 示 。 


代码 清单 8-33 ”开启 actuator 端点 代码 


spring.application.name-chapter8-6 
management.endpoints.web.exposure.include-* 


在 启动 类 中 注入 MeterRegistryCustomizer 类 , Chapter86Application 类 完整 内 容 如 代码 清单 8-34 
所 示 。 


代码 清单 8-34 ”启动 类 代码 


@SpringBootApplication 
public class Chapter86Application { 
public static void main(String[] args) { 
SpringApplication.run(Chapter86Application.class, args); 


GValue("$(spring.application.name]") 
private String applicationName; 


(Bean 
MeterRegistryCustomizer«MeterRegistry» metricsCommonTags() ( 
return registry -> registry.config().commonTags ("application", 
applicationName); 
} 


启动 项 目 ， 访 问 http://localhost:8080/actuator/prometheus， 可 以 看 到 如 图 8-16 所 示 的 页 面 。 
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8-16 查看 prometheus 端点 


8.3.4 Prometheus 配置 
进入 Prometheus 安装 目录 ， 打 开 prometheus.yml 文件 ， 在 scrape configs 中 加 入 如 下 配置 ， 如 


代码 清单 8-35 所 示 。 
代码 清单 8-35 Prometheus 配置 代码 


global: 
scrape interval: 
evaluation interval: 15s 


15s 


alerting: 
alertmanagers: 
- static configs: 
- targets: 
rule files: 
scrape configs: 
### 监控 prometheus 
- job name: 'prometheus" 


static configs: 
- targets: ['localhost:9090'] 
### 监控 SpringBoot MH 
- job name: 'chapter8-6"' 
Scrape interval: 5s 
metrics path: '/actuator/prometheus' 


static configs: 
- targets: ['127.0.0.1:8080'] 
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HZ Prometheus， 如 代码 清单 8-36 所 示 。 


代码 清单 8-36 ”启动 Prometheus 代码 


./ Prometheus 


启动 后 ， 访 问 http://localhost:9090/graph， 如 图 8-17 所 示 。 


8-17 Prometheus 管理 页 面 


单 击 导航 栏 Status 中 的 Targets， 可 以 查看 被 Prometheus 监控 的 应 用 ， 如 图 8-18 所 示 。 


Targets 


prometheus (1/1 up) EEE 


Endpoint 


test-project (1/1 up) EE] 


Endpoint 


图 8-18 查看 被 Prometheus 监控 的 页 面 


8.8.5 启动 Grafana 


启动 Grafana， 然 后 访问 http://localhost:3000/ 
login， 可 以 看 到 如 图 8-19 所 示 的 页 面 。 

输入 用 户 名 admin、 密 码 admin 进行 登录 。 添 
加 一 个 Prometheus 数据 源 ， 在 URL 处 配置 
Prometheus 地 址 ， 因 为 都 是 本 地 安装 ， 所 以 配置 
http://localhost:9090 即 可 ， 配 置 完成 后 ， 单 击 Save Grafana 
& Test 按钮 ， 配 置 页 如 图 8-20 所 示 。 

对 于 监控 ， 这 里 推荐 一 个 Grafana 的 看 板 ， 地 
址 是 https://grafana.com/dashboards/6756, 如 图 8-21 
所 示 。 


图 8-19 Grafana 登录 页 面 
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© Data Sources / Prometheus-1 


... BRD 


1S Grafana Labs 


|| Spring Boot Stotistics 


B a || N E m Aa 
porter 


图 8-21 Grafana 查看 Dashboards 页 面 


单 击 Grafana 导航 栏 的 + 号 按钮 , 选择 import, 这 里 输入 6756, 然后 进入 如 图 8-22 所 示 的 页 


8-22 Grafana 导入 Dashboards 页 面 


Prometheus 选择 刚刚 添加 的 Prometheus-Data， 然 后 进入 监控 页 面 ， 如 图 8-23 所 示 。 
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图 8-23 Grafana 查看 指标 页 面 


从 图 8-23 中 可 以 看 到 ， 已 经 监控 到 了 我 们 想 要 监控 的 Spring Boot 应 用 ,这 个 监控 页 还 有 很 多 
监控 内 容 ， 比 如 HTTP Statistics、Tomcat Statistics 等 ， 如 图 8-24 所 示 。 


X — 器 Spring Boot Statistics - 


HiariCP Statistics 


HTTP St 


图 8-24 Grafana 监控 内 容 


在 这 个 监控 中 已 经 提供 了 足够 多 的 监控 查询 ， 当 然 ， 在 实际 开发 中 可 以 添加 自己 需要 监控 的 
内 容 ， 根 据 项 目 场景 添加 即 可 。 


8.4 小 25 


本 章 对 Spring Boot 服务 的 监控 组 件 进行 了 一 定 的 学 习 ， 从 而 保证 服务 的 可 用 性 。 相 信 经 过 本 
章 的 学 习 ， 读 者 对 监控 已 经 有 了 一 定 了 解 ， 并 且 可 以 预防 由 项 目 意外 瘫痪 造成 不 必要 的 影响 。 


Spring Boot 的 消息 之 旅 


消息 队列 的 英文 名 称 为 Message Queue， 通 常 简称 为 MQ.. MQ 是 一 种 应 用 程序 对 应 用 程序 的 
通信 方法 。 消 息 队列 是 分 布 式 系 统 中 不 可 或 缺 的 组 件 ， 主 要 解决 应 用 解 耦 、 异 步 消 息 、 流 量 削 峰 等 
问题 ， 实 现 高 性 能 、 高 可 用 、 可 伸缩 和 最 终 一 致 性 的 架构 。 如 今 常 用 的 开源 消息 队列 组 件 有 
RabbitMQ, Kafka. ActiveMQ, RocketMQ 等 。 

消息 队列 是 典型 的 消费 -生产 者 模式 ， 生 产 者 向 消息 队列 生产 消息 ， 消 费 者 可 以 从 订阅 的 队列 
中 读 取消 息 。 本 章 将 对 Spring Boot 使 用 RabbitMQ、Kafka、RocketMQ 消息 队列 进行 介绍 。 


9.4 RabbitMQ 消息 队列 


RabbitMQ 是 一 个 比较 常用 的 消息 队列 ,本 小 节 将 对 它 进行 介绍 , 并 介绍 Spring Boot 如 何 使 用 
RabbitMQ 。 


9.1.1 RabbitMQ 介绍 


RabbitMQ 是 一 个 由 Erlang 开发 的 AMQP (Advanced Message Queuing Protocol) 开源 实现 。 
很 多 人 可 能 并 不 知道 什么 是 AMQP. AMQP 是 一 个 提供 统一 服务 的 应 用 层 标准 高 级 消息 队列 协议 ， 
是 应 用 层 协 议 的 一 个 开放 标准 , 为 面向 消息 中 间 件 设计 。 基于 此 协议 的 客户 端 与 消息 中 间 件 可 以 传 
递 消息 ， 并 不 受 客户 端 /中 间 件 不 同 产品 、 不 同 开发 语言 等 条 件 的 限制 。 

RabbitMQ 是 由 RabbitMQ Technologies Ltd 开发 并 且 提 供 商 业 支 持 的 。 该 公司 在 2010 年 4 月 
被 SpringSource (VMWare 的 一 个 部 门 ) 收 购 。 在 2013 年 5 月 被 并 入 Pivotal. 其 实 VMWare, Pivotal 
和 EMC 本质 上 是 一 家 的 。 不 同 的 是 ，VMWare 是 独立 上 市 子 公 司 ， 而 Pivotal 整合 了 EMC 的 某 些 
资源 ， 现 在 并 没有 上 市 。 
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RabbitMQ 支持 多 种 客户 端 ， 如 Python、Ruby、.NET、Java、JMS、C、PHP、ActionScript、 
XMPP、STOMP 等 ， 支 持 Ajax。 用 于 分 布 式 系统 中 存储 转发 消息 ， 在 易 用 性 、 扩 展 性 、 高 可 用 性 
等 方面 都 有 不 错 的 表现 。 并 且 ， 正 如 RabbitMQ 官网 (官网 地 址 : http://www.rabbitmq.com/) 介绍 
的 ，RabbitMQ 在 全 球 范围 内 在 小 型 初创 公司 和 大 型 企业 中 进行 了 超过 35 000 次 RabbitMQ 生产 部 
署 ， 是 最 受 欢迎 的 开源 消息 代理 。RabbitMQ 很 轻 量 级 ， 易 于 在 内 部 和 云 中 部 署 。 它 支持 多 种 消息 
传递 协议 。RabbitMQ 可 以 部 署 在 分 布 式 和 联合 配置 中 ， 以 满足 高 规模 、 高 可 用 性 的 要 求 。 


9.1.2 RabbitMQ 的 几 种 角色 


RabbitMQ 是 一 个 消息 代理 ， 它 的 工作 就 是 接收 和 转发 消息 。 你 可 以 把 它 想象 成 一 个 邮局 : 你 
把 信件 放 入 邮箱 ， 邮 递 员 就 会 把 信件 投递 到 收 件 人 处 。 在 这 个 比喻 中 ，RabbitMQ 就 扮演 着 邮箱 、 
邮局 以 及 邮递 员 的 角色 。 

RabbitMQ 和 邮局 的 主要 区 别 在 于 它 不 处 理 纸 张 ， 而 是 接收 、 存 储 和 发 送 消息 (Message) 这 
种 二 进 制 数据 。 

下 面 是 RabbitMQ 和 消息 所 涉及 的 一 些 术语 。 

e 生产 (Producing ) 的 意思 就 是 发 送 。 发 送 消息 的 程序 就 是 一 个 生产 者 (Producer )。 我 们 一 般 

用 P 来 表示 ， 如 图 9-1 所 示 。 


图 9-1 发 送 消息 的 生产 者 


* [5| (Queue) 就 是 存在 于 RabbitMQ 中 邮箱 的 名 称 。 虽然 消息 的 传输 经 过 了 RabbitMQ 和 应 
用 程序 ， 但 是 它 只 能 存储 于 队列 中 。 实 质 上 ， 队 列 就 是 一 个 巨大 的 消息 缓冲 区 ， 它 的 大 小 只 
受 主机 内 存 和 硬盘 限制 。 多 个 生产 者 ( Producers ) 可 以 把 消息 发 送 给 同一 个 队列 ， 同 样 ， 多 
个 消费 者 (Consumers ) 也 能 够 从 同一 个 队列 中 获取 数据 。 队 列 可 以 绘制 ， 如 图 9-2 所 示 。 


queue rame < 一 队列 名 称 


图 9-2 队列 
e 在 这 里 ， 消 费 (Consuming) 和 接收 (Receiving) 是 同一 个 意思 。 一 个 消费 者 (Consumer) 
就 是 一 个 等 待 获取 消息 的 程序 。 我 们 把 它 绘制 为 C， 如 图 9-3 所 示 。 


9-3 消费 者 
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需要 指出 的 是 ， 生 产 者 、 消 费 者 、 代 理 不 需要 待 在 同一 个 设备 上 。 事 实 上 ， 大 多 数 应 用 确实 
不 会 将 它们 放 在 同一 台 机 器 上 。 


9.1.3 RabbitMQ 的 几 种 模式 


RabbitMQ 包含 几 种 经 典 的 消息 传递 模式 ， 下 面 分 别 进 行 介 绍 。 
1. 简单 模式 


在 使 用 RabbitMQ 消息 队列 的 时 候 , 最 容易 理解 的 就 是 点 对 点 消息 发 送 。 我 们 可 以 这 样 理 解 这 
种 模式 ， 比 如 张 三 给 李 四 发 送信 息 ， 首 先 张 三 编辑 短信 ， 编 辑 完成 后 发 送 到 信息 中 转 站 ， 然 后 由 中 
转 站 转发 送 到 李 四 的 手机 里 。 如 图 9-4 所 示 ，P 代表 生产 者 ，C 代表 消费 者 ， 中 间 的 盒子 代表 消费 
者 保留 的 消息 缓冲 区 ， 也 就 是 队列 ， 这 种 模式 多 用 于 聊天 场景 。 

2. 工作 队列 模式 

在 发 送 消息 时 ， 还 有 这 样 一 种 场景 ， 就 是 将 一 个 消息 发 送 给 多 个 消费 者 。 如 果 没 有 消息 队列 ， 
我 们 就 只 能 利用 HTTP. 或 者 其 他 方式 对 多 个 消费 者 请 求 数据 : 如 果 使 用 消息 队列 , 我 们 只 需要 将 消 
息 推送 到 工作 队列 中 就 可 以 解决 问题 。 

工作 队列 (又 称 任务 队列 ，Task Queues) 是 为 了 避免 等 待 一 些 占 用 大 量 资源 、 时 间 的 操作 。 
当 我 们 把 任务 Task〉 当 作 消 息 发 送 到 队列 中 时 ， 一 个 运行 在 后 台 的 工作 者 “Worker) 进程 就 会 取 
出 任务 ， 然 后 进行 处 理 。 当 你 运行 多 个 工作 者 “Workers) 时 ， 任 务 就 会 在 它们 之 间 共 享 。 

这 个 概念 在 网 络 应 用 中 是 非常 有 用 的 ， 多 用 于 资源 调度 或 抢 红包 等 场景 ， 它 可 以 在 短暂 的 
HTTP 请 求 中 处 理 一 些 复杂 的 任务 。 如 图 9-5 所 示 是 工作 队列 模式 的 消息 流转 图 。 


hdlo 
图 9-4 简单 模式 的 消息 流转 图 9-5 工作 队列 模式 的 消息 流转 图 


3. 订阅 模式 


生产 者 (Producer) 只 需要 把 消息 发 送 给 一 个 交换 机 (Exchange) 。 交 换 机 非常 简单 ， 它 一 边 
从 生产 者 接收 消息 , 一 边 把 消息 推送 到 队列 。 交 换 机 必须 知道 如 何 处 理 它 接收 到 的 消息 ， 是 应 该 推 
送 到 指定 的 队列 , 还 是 推送 到 多 个 队列 , 或 者 直接 忽略 消息 。 这 些 规 则 是 通过 交换 机 类 型 (Exchange 
Type) 来 定义 的 。 

有 几 个 可 供 选 择 的 交换 机 类 型 : 直 连 (Direct) 交换 机 、 主 题 (Topic) 交换 机 、 头 〈Headers) 
交换 机 和 扇 型 (Fanout) 交换 机 。 

可 能 到 这 里 还 是 不 好 理解 订阅 模式 与 工作 队列 模式 的 区 别 ， 其 实 最 简单 的 区 别 就 是 如 果 订阅 
模式 有 多 个 消费 者 , 那么 所 有 消费 者 都 会 收 到 消息 ,而 工作 队列 模式 只 有 一 个 消费 者 进行 消费 。 订 
阅 模式 多 用 于 广告 、 群 聊 等 功能 。 如 图 9-6 所 示 是 订阅 模式 的 消息 流转 图 。 
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amqp.gen-S9b... 


amqp.gen-Agl... 


9-6 订阅 模式 的 消息 流转 图 


4. 路 由 模式 


生产 者 将 消息 发 送 到 交换 机 ， 在 绑 定 队列 和 交换 机 的 时 候 有 一 个 路 由 key， 生 产 者 发 送 的 消息 
会 指定 路 由 key， 消 息 只 会 发 送 到 key 相同 的 队列 ， 接 着 监听 该 队列 消费 者 的 消费 信息 。 

路 由 模式 很 好 理解 ， 其 实 可 以 理解 为 订阅 模式 的 特例 ， 需 要 根据 指定 key 来 发 布 和 订阅 。 一 
般 来 说 ， 路 由 模式 多 用 于 项 目 中 的 报错 信息 。 如 图 9-7 所 示 是 路 由 模式 的 消息 流转 图 。 


Q1 


type-direct 


orange 


图 9-7 路 由 模式 的 消息 流转 图 


5. topic 模式 
topic 模式 与 路 由 模式 大 致 相同 ， 不 同 的 是 topic 模式 通过 匹配 符 订阅 多 个 主题 的 消息 ， 比 如 : 


e *( 星 号 ) 用 来 表示 一 个 单词。 
e (ES) 用 来 表示 任意 数量 ( 零 个 或 多 个 ) 单词 


topic 模式 的 消息 流转 图 如 图 9-8 所 示 。 


Q1 


type-topic 


*.orange.* 


*.* rabbit Q2 


图 9-8 topic 模式 的 消息 流转 图 


在 这 个 例子 里 ， 我 们 发 送 的 所 有 消息 都 是 用 来 描述 小 动物 的 。 发 送 的 消息 所 携带 的 路 由 键 是 
由 3 个 单词 组 成 的 。 路 由 键 里 的 第 一 个 单词 描述 的 是 动物 的 颜色 , 如 图 9-8 所 示 的 orange (橙色 ) ; 
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第 二 个 单词 是 动物 的 种 类 ， 如 图 9-8 所 示 的 rabbit (兔子 ) ; 第 三 个 单词 是 动物 的 行为 ， 如 图 9-8 
所 示 的 lazy (懒惰)。 
为 此 ， 我 们 设置 了 3 个 绑 定 键 ， 这 3 个 绑 定 键 可 以 总 结 为 : 


* QI 队列 对 所 有 的 檬 色 动物 都 感 兴趣 。 
e Q2 队列 则 是 对 所 有 的 兔子 和 所 有 懒惰 的 动物 感 兴趣 。 


举 个 例子 ， 一 个 携带 quick.orange.rabbit 的 消息 将 会 被 分 别 投递 给 Q1 和 Q2 队列 ， 携 带 
lazy.orange.elephant 的 消息 同样 会 投递 给 这 两 个 队列 。 另 一 方面 ， 携 带 quick.orange.fox 的 消息 会 投 
递 给 第 一 个 队列 ， 携 带 lazy.brown.fox 的 消息 会 投递 给 第 二 个 队列 。 携 带 lazy.pink.rabbit 的 消息 只 
会 投递 给 第 二 个 队列 一 次 ， 即 使 它 同时 匹配 第 二 个 队列 的 两 个 绑 定 。 携 带 quick.brown.fox 的 消息 
不 会 投递 给 任何 一 个 队列 。 

如 果 我 们 违反 约定 ,发 送 了 一 个 携带 一 个 单词 或 者 4 个 单词 (orange 或 quick.orange.male.rabbit) 
的 消息 ， 发 送 的 消息 不 会 投递 给 任何 一 个 队列 ， 并 且 会 丢失 掉 。 

但 是 ， 即 使 lazy.orange.male.rabbit 有 4 个 单词 ， 还 是 会 匹配 最 后 一 个 绑 定 ， 并 且 投 递 到 第 二 
个 队列 。 


6. 远程 过 程 调用 

RPC 是 指 远 程 过 程 调用 。 也 就 是 说 有 两 台 服务 器 A 和 B， 一 个 应 用 部 署 在 A 服务 器 上 ， 想 要 
调用 B 服务 器 上 应 用 提供 的 函数 /方法 ， 由 于 不 在 一 个 内 存 空间 ， 因 此 不 能 直接 调用 ， 需 要 通过 网 
络 来 表达 调用 的 语义 和 传达 调用 的 数据 。 


一 般 在 RabbitMQ 中 做 RPC 是 很 简单 的 。 客 户 端 发 送 请 求 消 息 ， 服 务 器 回复 响应 的 消息 。 为 
了 接收 响应 的 消息 ， 我 们 需要 在 请 求 消息 中 发 送 一 个 回调 队列 。 消 息 流转 图 如 图 9-9 所 示 。 
rpc queue 


Request 
reply to-amqp.genXa2... 
correlation id-abc 


Reply 1 
correlation id-abc 


图 9-9 远程 过 程 调用 模式 的 消息 流转 图 


Server 


Client 


reply to- amq.gen-X a2... 


9.1.4 Spring Boot 使 用 RabbitMQ 


在 Spring Boot 中 使 用 RabbitMQ 前 需要 启动 RabbitMQ. 当 启 动 RabbitMQ Ja, 使 用 RabbitMQ 
大 致 分 为 如 下 几 步 : 


(1) 加 入 RabbitMQ 依赖 。 
(2) 配置 RabbitMQ 服务 信息 。 
(3) 编写 消费 者 和 生产 者 。 
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熟知 上 述 步 又 后 ， 接 下 来 我 们 新 建 项 目 ， 在 项 目 中 加 入 spring-boot-starter-amqp 依赖 ， 如 代码 
清单 9-1 所 示 。 


代码 清单 9-1 RabbitMQ 项 目 引 入 amqp 依赖 


«dependency» 
XgroupId»org.springframework.boot«/groupId» 
X«artifactId»spring-boot-starter-amqp«/artifactId» 

</dependency> 


接 下 来 ， 需 要 在 配置 文件 中 配置 RabbitMQ 服务 信息 ， 如 代码 清单 9-2 所 示 。 


代码 清单 9-2 RabbitMQ 项 目 配置 RabbitMQ 


spring.rabbitmq.host=RabbitMO 服务 IP 
spring.rabbitmq.port-5672 
spring.rabbitmq.username-admin 


spring.rabbitmq.password-admin 


一 般 来 说 ， 消 息 队 列 发 送 的 数据 都 是 实体 对 象 ， 这 里 创建 一 个 商品 实体 类 Goods 进行 数据 传 
输 。Goods 实体 内 容 如 代码 9-3 清单 所 示 。 


代码 清单 9-3 ”RabbitMQ 项 目 发 送 实体 代码 


public class Goods implements Serializable ( 
private static final long serialVersionUID - 6629065135155452917L; 
private Long goodsId; 
private String goodsName; 
private String goodsIntroduce; 
private Double goodsPrice; 


。// 省 略 set. Get 方法 


) 


这 里 以 使 用 RabbitMQ 的 简单 消息 发 送 、Topic 转发 模式 消息 发 送 和 Fanout Exchange 模式 消息 
发 送 3 种 为 例 ， 使 用 Spring Boot 操作 RabbitMQ 进行 消息 发 送 和 接收 。 

1. 简单 消息 发 送 

简单 消息 发 送 很 好 理解 ， 前 面 已 经 介绍 过 了 ， 其 实 就 是 发 送 者 将 消息 发 送 到 消息 队列 ， 再 由 
消息 队列 转发 到 消费 者 。 首 先 创建 一 个 简单 发 送 消息 配置 DirectConfig 类 ， 在 类 上 加 入 注解 
@Configuration， 表 明 这 是 一 个 配置 类 。 在 类 中 定义 一 个 点 对 点 消息 发 送 的 常量 值 用 作 消 息 队列 名 
称 ， 同 时 向 Spring 注入 Queue 类 并 创建 消息 队列 ， 完 整 内 容 如 代码 清单 9-4 所 示 。 
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代码 清单 9-4 RabbitMQ 项 目 简单 消息 发 送 配 置 


GConfiguration 
public class DirectConfig ( 
public static final String DIRECT QUEUE - "direct.queue"; 


GBean 


public Queue directQueue() ( 
// 第 一 个 参数 是 队列 名 字 ， 第 二 个 参数 是 指 是 否 持久 化 


return new Queue("direct.queue", true); 


H 
接 下 来 创建 一 个 消息 发 送 者 DirectSender 类 。 一 般 使 用 消息 发 送 都 是 通过 操作 AmqpTemplate 
类 ， 所 以 首先 注入 这 个 类 。 然 后 创建 一 个 发 送 消息 的 方法 ， 调 用 convertAndSend() 方 法 进行 消息 发 


送 。DirectSender 类 完整 内 容 如 代码 清单 9-5 所 示 。 


代码 清单 9-5 RabbitMQ 项 目 简单 消息 发 送 生产 者 


GComponent 
public class DirectSender ( 
private static final Logger log - 


LoggerFactory.getLogger (DirectSender.class); 


GAutowired 
private AmqpTemplate amgpTemplate; 


public void sendDirectQueue() ( 
new Goods (System.currentTimeMillis (), "测试 商品 ", "这 是 一 


Goods goods 


个 测试 的 商品 "， 98 . 6) ; 
log.info ("简单 消息 已 经 发 送 ") ; 

// 第 一 个 参数 是 指 要 发 送 到 哪个 队列 ， 第 二 个 参数 是 指 要 发 送 的 内 容 

this.amqpTemplate.convertAndSend (DirectConfig.DIRECT QUEUE, goods); 


) 
消息 发 送 者 已 经 创建 好 了 。 接 下 来 创建 一 个 消息 接收 者 DirectReceiver 类 , 使 用 @RabbitListener 
设置 监听 队列 的 名 称 ， 方 法 的 参数 就 是 接收 到 的 实体 对 象 ， 完 整 内 容 如 代码 清单 9-6 所 示 。 


代码 清单 9-6 RabbitMQ 项 目 简单 消息 发 送 消费 者 


@Component 
public class DirectReceiver { 
private static final Logger log = LoggerFactory.getLogger 


(DirectReceiver.class); 


// queues 是 指 要 监听 的 队列 的 名 字 
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GRabbitListener(queues = DirectConfig.DIRECT QUEUE) 
public void receiverDirectQueue (Goods goods) ( 
1log.info(" 简 单 消 息 接受 成 功 ， 参数 是 : " + goods.toString()); 
} 
} 


最 后 创建 一 个 DirectController 类 进行 测试 ， 这 里 仅 调用 directSender 生产 者 发 送 消息 的 方法 ， 
完整 内 容 如 代码 清单 9-7 所 示 。 


代码 清单 9-7 RabbitMQ 项 目测 试 类 


GRestController 
public class DirectController ( 
GAutowired 


private DirectSender directSender; 


GGetMapping("directTest") 
public void directTest() ( 
directSender.sendDirectQueue(); 


} 


} 


启动 应 用 ， 在 浏览 器 中 访问 http://localhost:8080/directTest， 可 以 看 到 控制 台 如 图 9-10 所 示 。 


图 9-10 简单 消息 发 送 控制 台 
我 们 再 来 查看 一 下 RabbitMQ 管理 页 面 ， 如 图 9-11 所 示 。 


D- Usar: admin Log out 
ka Rabbit — rs 

RabbtMQ 3.6.8, Erlang. R16002-1 
Overview ^ Connections Channels Exchanges F) admin Virtual host: AI 
Queues 


+ All queues (5) 


Pagination 


Page[ 13] ofi - Fiter: Regex playing 5 ems , page size up t 108 
Overviow Messages Message rates 

Virtual host Name 。 Features State Ready Unacked Total incoming deliver/ get ack 

j direct.queue. D running o o o 0095 0.00/s — 0.00/s 


9-11. 简单 消息 发 送 RabbitMQ 管理 页 面 
刚刚 创建 的 队列 在 RabbitMQ 管理 页 面 也 可 以 查看 。 至 此 ， 简 单 消息 发 送 成 功 。 
2. Topic 转发 模式 消息 发 送 


Topic 转发 模式 是 通过 设置 主题 的 方式 来 进行 消息 发 送 和 接收 的 ， 这 里 需要 使 用 到 Route-key， 
创建 一 个 TopicConfig 类 配置 主题 和 交换 机 ， 完 整 内 容 如 代码 清单 9-8 所 示 。 
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GConfiguration 

public class TopicConfig ( 
public static final String TOPIC QUEUE "topic.queuel"; 
public static final String TOPIC QUEUE2 - "topic.queue2"; 
public static final String TOPIC EXCHANGE - "topic.exchange"; 


LI 


GBean 
public Queue topicQueuel() { 
return new Queue(TOPIC QUEUE1); 
h 
GBean 
public Queue topicQueue2() ( 
return new Queue(TOPIC QUEUE2) ; 
lh 
GBean 
public TopicExchange topicExchange() ( 
return new TopicExchange (TOPIC EXCHANGE); 
$ 
@Bean 
public Binding topicBindingl() { 
return BindingBuilder.bind (topicQueuel()).to(topicExchange()). 
with("topic.messge"); 
) 
GBean 
public Binding topicBinding2() { 
return BindingBuilder.bind (topicQueue2 ()).to(topicExchange()). 
with ("topic.#"); 
$ 
} 


生产 者 发 送 消 息 还 是 使 用 convertAndSend() 方 法 ， 不 过 需要 在 参数 内 设置 Route-key， 完 整 内 
容 如 代码 清单 9-9 所 示 。 


代码 清单 9-9 RabbitMQ 项 目 Topic 模式 生产 者 


GComponent 
public class TopicSender ( 
private static final Logger log - 
LoggerFactory.getLogger (TopicSender.class); 
GAutowired 
private AmqpTemplate amqpTemplate; 


public void sendTopicQueue() ( 
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Goods goods1 = new Goods (System.currentTimeMi11is(), "测试 商品 1", "这 是 
第 一 个 测试 的 商品 ", 98 . 6) ; 

Goods goods2 = new Goods (System.currentTimeMillis ()," 测 试 商品 2", "这 是 
第 二 个 测试 的 商品 "，, 100.0); 

log.info("TopicSender 已 发 送 消息 ") ; 

// 第 一 个 参数 ， TopicExchange 名 字 

// 第 二 个 参数 : Route-Key 

// 第 三 个 参数 : 要 发 送 的 内 容 

this.amqpTemplate.convertAndSend(TopicConfig.TOPIC EXCHANGE, 
"topic.messge", goodsl ); 

this.amqpTemplate.convertAndSend(TopicConfig.TOPIC EXCHANGE, 
"topic.messge2", goods2); 

) 
) 


这 里 其 实 是 创建 两 个 消费 者 ， 分 别 订 阅 不 同 主题 的 内 容 。 测 试 的 目的 很 简单 ， 消 费 者 2 订阅 
的 主题 包含 生产 者 发 送 的 两 条 信息 , 消费 者 1 只 能 收 到 其 中 的 一 条 信息 。 消 费 者 完整 内 容 如 代码 清 
单 9-10 所 示 。 


代码 清单 9-10 RabbitMQ 项 目 topic 模式 消费 者 


GComponent 
public class TopicReceiver ( 
private static final Logger log - LoggerFactory.getLogger 
(TopicReceiver.class); 


GRabbitListener(queues = TopicConfig.TOPIC QUEUE1) 

public void receiveTopicl(Goods goods) ( 
log.info("receiveTopic1 收 到 消息 : " + goods.toString()); 

b 

GRabbitListener(queues - TopicConfig.TOPIC QUEUE2) 

public void receiveTopic2 (Goods goods) { 
log.info("receiveTopic2 收 到 消息 : " + goods.toString()); 


} 


创建 TopicController 类 进行 调用 测试 ， 如 代码 清单 9-11 所 示 。 


代码 清单 9-11 RabbitMQ Ji El Topic 模式 测试 类 


@RestController 

public class TopicController { 
@Autowired 
Private TopicSender topicSender; 


GGetMapping("topicTest") 
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public void topicTest() ( 
topicSender.sendTopicQueue () ; 


} 


在 浏览 器 中 访问 http://localhost:8080/topicTest， 查 看 控制 台 ， 如 图 9-12 所 示 。 至 此 ，Topic f£ 
发 模式 消息 发 送 已 经 完成 。 


图 9-12 Topic 模式 控制 台 
息 发 送 
Fanout Exchange 模式 消息 发 送 是 指 广播 型 消息 发 送 ， 订 阅 了 这 个 交换 机 的 消息 都 会 收 到 消息 内 


容 。Fanout Exchange 模式 与 Topic 模式 有 些 类 似 ， 但 是 不 需要 设置 Route-key。 完 整 内 容 如 代码 清单 
9-12 所 示 。 


代码 清单 9-12 RabbitMQ 项 目 Fanout Exchange 模式 配置 


GConfiguration 


3. Fanout Exchange 模式 ; 


public class FanoutConfig ( 
public static final String FANOUT QUEUE1 
public static final String FANOUT QUEUE2 "fanout.queue2"; 
public static final String FANOUT EXCHANGE - "fanout.exchange"; 
(Bean 
public Queue fanoutQueuel() ( 
return new Queue (FANOUT QUEUE1) ; 


anout.queuel"; 


b 
GBean 
public Queue fanoutQueue2() ( 
return new Queue (FANOUT QUEUE2); 
} 
@Bean 
public FanoutExchange fanoutExchange() ( 
return new FanoutExchange (FANOUT EXCHANGE); 
ij 
GBean 
public Binding fanoutBindingl() ( 
return BindingBuilder.bind (fanoutQueuel ()).to(fanoutExchange()); 
l 
GBean 
public Binding fanoutBinding2() ( 
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return BindingBuilder.bind(fanoutQueue2 ()).to(fanoutExchange()); 


) 


消息 发 送 者 依然 调用 convertAndSend() 方 法 。 这 里 需要 注意 , 第 二 个 参数 设置 为 空 因 为 Fanout 
交换 机 不 处 理 路 由 键 , 只 是 简单 地 将 队列 绑 定 到 交换 机 上 , 每 个 发 送 到 交换 机 的 消息 都 会 被 转发 到 
与 该 交换 机 绑 定 的 所 有 队列 上 。 生 产 者 内 容 如 代码 清单 9-13 所 示 。 


代码 清单 9-13 RabbitMQ 项 目 Fanout Exchange 模式 生产 者 


GComponent 
public class FanoutSender ( 
private static final Logger log - LoggerFactory.getLogger 
(FanoutSender.class); 
GAutowired 
private AmqpTemplate amgpTemplate; 


public void sendFanoutQueue() ( 
Goods goods = new Goods (System.currentTimeMillis (), "测试 商品 ", "这 是 一 
个 测试 的 商品 "， 98.6); 
log.info("sendFanoutQueue 已 发 送 消息 "); 
this.amqpTemplate.convertAndSend(FanoutConfig.FANOUT EXCHANGE, "", 
goods ); 
} 


} 


消费 者 只 是 创建 两 个 消息 队列 来 接收 消息 ， 因 为 使 用 的 是 同一 个 交换 机 ， 所 以 都 会 收 到 消息 。 
消费 者 内 容 如 代码 清单 9-14 所 示 。 


代码 清单 9-14 RabbitMQ 项 目 Fa 


GComponent 
public class FanoutReceiver ( 
private static final Logger log = 
LoggerFactory.getLogger (FanoutReceiver.class); 


GRabbitListener(queues - FanoutConfig.FANOUT QUEUE1) 

public void receiveFanoutl(Goods goods) | 
log.info("receiveFanoutQueuel 监听 到 消息 : " + goods.toString()); 

b 

GRabbitListener(queues - FanoutConfig.FANOUT QUEUE2) 

public void receiveFanout2 (Goods goods) ( 
log.info("receiveFanoutQueue2 监听 到 消息 : " + goods.toString()); 


) 


创建 FanoutController 来 调用 消息 发 送 ， 如 代码 清单 9-15 所 示 。 
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代码 清单 9-15  RabbitMQ 项 目 fanout 模式 测试 类 


GRestController 

public class FanoutController ( 
GAutowired 
private FanoutSender fanoutSender; 


GGetMapping("fanoutTest") 
public void fanoutTest()( 
fanoutSender.sendFanoutQueue(); 
} 
} 


在 浏览 器 中 访问 http:Wlocalhost:8080/fanoutTest， 查 看 控制 台 , 如 图 9-13 所 示 。 到 这 里 ，Fanout 
Exchange 模式 消息 发 送 已 经 完成 。 


图 9-13 Fanout Exchange 模式 控制 台 


RabbitMQ 相关 内 容 到 这 里 就 介绍 完了 。 由 于 篇 幅 原 因 ， 不 能 面面俱到 ， 只 是 列举 了 3 个 常用 
的 方式 来 供 读者 参阅 。 


9.2 Kafka 消息 队列 


Kafka 是 由 Apache 软件 基金 会 开发 的 一 个 开源 流 处 理 平台 ， 被 誉 为 最 高 吞吐 量 的 常用 消息 队 
列 。 本 节 我 们 来 学 习 Spring Boot 如 何 使 用 Kafka 消息 队列 。 


9.2.1 Kafka 介绍 


Kafka( 官 网 地 址 : http://kafka.apache.org/) 是 一 种 高 吞吐 量 的 分 布 式 发 布 订阅 消息 系统 ， 最 
T] rfi Linkedin 公司 开发 ,于 2010 年 底 在 Github 首次 开源 ,初始 版 本 为 0.7.0。 在 2011 4E 7 H , Linkedin 
公司 将 Kafka 项 目 贡 献 给 Apache， 成 为 Apache RJSE(LX H, TE 2012 年 10 H, Kafka 从 Apache 
孵化 器 正式 毕业 ， 成 为 Apache 顶级 项 目 。 在 2014 年 , 为 了 Kafka 更 好 地 发 展 ， 几 名 Kafka 的 核心 
开发 人 员 离 开 了 Linkedin, BEA f Confluent 公司 ， 继 续 推进 Kafka 的 发 展 。 

在 业界 ，Kafka 无 疑 是 最 高 吞吐 量 的 分 布 式 流 处 理 平台 ， 并 且 它 也 是 一 个 优秀 的 分 布 式 MQ， 
其 通过 Zookeeper 实现 了 高 可 用 。 同 时 ，Kafka 可 以 做 的 事情 非常 多 ， 下 面 详细 介绍 。 
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1. 消息 


Kafka 可 以 很 好 地 昔 代 传 统 的 消息 代理 。 消 息 代理 的 使 用 有 多 种 场景 ， 如 将 数据 处 理 与 数据 生 
成 器 分 离 、 缓 冲 未 处 理 的 消息 等 。 与 大 多 数 消息 传递 系统 相 比 ，Kafka 具有 更 好 的 吞吐 量 、 内 置 分 
区 、 复制 和 容错 功能 ， 这 使 其 成 为 大 规模 消息 处 理应 用 程序 的 理想 解决 方案 。 通常 消息 传递 使 用 较 
低 的 吞吐 量 ， 但 可 能 要 求 较 低 的 端 到 端 延迟 ，Kafka 提供 强大 的 持久 性 来 满足 这 一 要 求 。 

在 这 个 领域 ，Kafka 可 与 传统 的 消息 传递 系统 (如 ActiveMQ 或 RabbitMQ) HRK. 


2. 网 站 活动 跟踪 


Kafka. 的 初始 用 例 是 能 够 将 用 户 活动 跟踪 管道 重建 为 一 组 实时 发 布 - 订阅 源 。 这 意味 着 网 站 
活动 (页面 查看 、 搜 索 或 用 户 可 能 采取 的 其 他 操作 ) 将 发 布 到 中 心 主题 ， 每 个 活动 类 型 包含 一 个 主 
题 。 这 些 订 阅 源 提供 了 一 系列 用 例 ， 包 括 实时 处 理 、 实 时 监控 以 及 加 载 到 Hadoop 或 离线 数据 仓库 
系统 以 进行 离线 处 理 和 报告 。 因为 每 个 用 户 页 面 视图 生成 了 许多 活动 消息 , 活动 跟踪 的 数据 量 通常 
非常 大 。 


3. 度量 


Kafka 通常 用 于 监控 数据 。 这 涉及 从 分 布 式 应 用 程序 聚合 统计 信息 ,并 且 从 中 生成 可 操作 的 集 
中 数据 源 。 


4. 日 志 聚 合 


许多 人 使 用 Kafka 作为 日 志 聚 合 解决 方案 的 蔡 代 品 。 日 志 聚 合 通常 从 服务 器 收集 物理 日 志文 
件 ， 并 将 它们 放 在 中 央 位 置 〈《 可 能 是 文件 服务 器 或 HDFS) 进行 处 理 。Kafka 从 这 些 日 志 中 提取 信 
息 , 并 将 日 志 或 事件 数据 更 清晰 地 抽象 为 消息 流 。 这样 可 以 更 低 延 迟 的 处 理 并 更 容易 支持 多 个 数据 
源 和 分 布 式 数据 消耗 。 与 Scribe 或 Flume 等 以 日 志 为 中 心 的 系统 相 比 ，Kafka 提供 了 同样 出 色 的 性 
能 ， 由 于 复制 而 具有 更 强 的 耐用 性 保证 ， 以 及 更 低 的 端 到 端 延迟 。 


5. 流 处 理 


许多 Kafka 用 户 在 处 理由 多 个 阶段 组 成 的 管道 时 处 理 数据 ， 其 中 原始 输入 数据 从 Kafka 主题 中 
消费 ， 然 后 聚合 、 修 饰 或 通过 其 他 方式 转换 为 新 主题 ， 以 供 进一步 消费 或 后 续 处 理 。 例 如 ， 用 于 推 
荐 新 闻 文 章 的 处 理 管道 可 以 从 RSS 订阅 源 抓 取 文 章 内容 并 将 其 发 布 到 “文章 ”主题 ; 进一步 处 理 可 
能 会 对 此 内 容 进行 规范 化 或 把 重复 数据 删除 ， 并 将 已 清理 的 文章 内 容 发 布 到 新 主题 ， 最 终 处 理 阶段 
可 能 会 尝试 向 用 户 推荐 此 内 容 。 此 类 处 理 管道 基于 各 个 主题 创建 实时 数据 流 的 图 形 。 从 0.10.0.0 版 本 
开始 ， 这 是 一 个 轻 量 级 但 功能 强大 的 流 处 理 库 ， 名 为 Kafka Streams, E Apache Kafka 中 可 用 于 执行 
上 述 数据 处 理 。 除 了 Kafka Streams 之 外 ， 其 他 开源 流 处 理工 具 包括 Apache Storm 和 Apache Samza。 


6. 活动 采购 


事件 源 是 一 种 应 用 程序 设计 风格 ,按照 时 间 来 记录 状态 的 更 改 。Kafka 可 以 存储 非常 多 的 日 志 
数据 ， 使 其 成 为 以 这 种 风格 构建 的 应 用 程序 的 出 色 后 端 。 
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7. 提交 日 志 


Kafka 可 以 从 外 部 为 分 布 式 系统 提供 日 志 提交 功能 。 该 日 志 有 助 于 在 节点 之 问 复制 数据 ,采用 
重新 同步 机 制 可 以 从 失败 的 节点 恢复 数据 。Kafka 中 的 日 志 压缩 功能 有 助 于 支持 此 用 法 。 在 这 种 用 
法 中 ，Kafka 类 似 于 Apache BookKeeper 项 目 。 


9.2.2 Spring Boot 使 用 Kafka 


在 Spring Boot 中 使 用 Kafka 的 过 程 与 使 用 RabbitMQ 大 致 一 致 ， 分 为 如 下 几 步 : 


(1) 加 入 Kafka 依赖 。 
(2) 配置 Kafka 服务 信息 。 
(3) 编写 消费 者 和 生产 者 。 
在 使 用 前 需要 安装 Kafka 服务 。 本 节 Spring Boot 使 用 Kafka 消息 队列 仅 以 发 送 实体 对 象 为 例 ， 


发 送 的 实体 还 是 9.1 节 使 用 的 商品 实体 Goods 类 。 新 建 项 目 ， 首 先 在 pom 文件 中 加 入 Kafka 依赖 ， 
如 代码 清单 9-16 所 示 。 


代码 清单 9-16 Kafka 项 目 依赖 代码 


<dependency> 
<groupId>org.springframework.kafka</groupId> 
<artifactId>spring-kafka</artifactId> 
</dependency> 


接 下 来 ， 在 配置 文件 中 配置 Kafka 生产 者 和 消费 者 的 信息 ， 如 代码 清单 9-17 所 示 。 


代码 清单 9-17 Kafka 项 目 配置 文件 


### producer 配置 
spring.kafka.producer.bootstrap-servers-Kafka 服务 地 址 :9092 


### consumer 配置 
spring.kafka.consumer.bootstrap-servers-Kafka 服务 地 址 :9092 
spring.kafka.consumer.group-id-goods 
spring.kafka.consumer.enable-auto-commit-true 
spring.kafka.consumer.auto-offset-reset-latest 


spring.kafka.template.default-topic-goods 


创建 一 个 生产 者 KafkaSender 25, TE Kafka 消息 队列 中 使 用 消息 发 送 的 时 候 操作 的 都 是 
KafkaTemplate 类 。 首 先 注 入 这 个 类 ， 然 后 调用 send 方法 ， 定 义 主 题 为 goods， 完 整 内 容 如 代码 清 
单 9-18 所 示 。 
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代码 清单 9-18 ”Kafka 项 目 生产 者 代码 


GComponent 
public class KafkaSender ( 
private static final Logger log - LoggerFactory.getLogger 
(KafkaSender.class); 
GAutowired 
private KafkaTemplate«String, String» kafkaTemplate; 


public void send() ( 
Goods goods = new Goods (System.currentTimeMi11is(), "测试 商品 ", "这 是 一 
个 测试 的 商品 "， 98 . 6) ; 
log.info("KafkaSender 已 发 送 消息 ") ; 
kafkaTemplate.send("goods", goods.toString()); 


) 


创建 一 个 消费 者 KafkaReceiver 类 ， 使 用 Kafka 消息 队列 消费 者 的 时 候 ， 其 实 是 使 用 
@KafkaListener 注解 来 监听 对 应 的 主题 。 经 过 9.1 节 的 学 习 ， 读 者 应 该 大 致 有 了 思路 ， 这 里 只 不 过 
是 使 用 的 类 或 注解 不 同 而 已 。 完 整 KafkaReceiver 类 内 容 如 代码 清单 9-19 所 示 。 


马 清单 9-19 Kafka 项 目 消费 


@Component 
public class KafkaReceiver { 
private static final Logger log = LoggerFactory.getLogger 
(KafkaReceiver.class); 


@KafkaListener (topics = "goods") 
public void send(ConsumerRecord«?, ?» record) ( 
Optional«?» kafkaMessage = Optional.ofNullable (record.value()); 
if (kafkaMessage.isPresent()) ( 
Object messge - kafkaMessage.get(); 
log.info(" [KafkaListener 监听 到 消息 】" + messge); 


) 


最 后 创建 一 个 KafkaController 类 进行 调用 消息 发 送 ， 如 代码 清单 9-20 所 示 。 


代码 清单 9-20 Kafka 项 目测 试 类 代码 


@RestController 

public class KafkaController { 
@Autowired 
private KafkaSender kafkaSender; 
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GGetMapping ("testKafka") 
public void testKafka()( 
kafkaSender.send(); 
L 
$ 


启动 项 目 ， 在 浏览 器 中 访问 http://localhost:8080/testKafka， 然 后 查看 控制 台 ， 如 图 9-14 所 示 。 


图 9-14 Kafka 项 目 控制 台 输出 


到 这 里 , 使 用 Kafka 消息 队列 已 经 完成 了 。 其 实 Kafka 可 以 做 的 不 只 是 消息 , 还 有 很 多 方面 的 
使 用 ， 具 体内 容 可 以 查阅 官网 来 进行 学 习 。 


9.3 RocketMQ 消息 队列 


9.3.1 RocketMQ 介绍 


Apache RocketMQ〔 官 网 地 址 : http://rocketmq.apache.org) 是 由 阿里 巴巴 集团 开源 的 大 型 消息 
队列 ， 现 在 已 经 贡献 给 了 Apache 开源 基金 会 ， 同 时 是 一 个 分 布 式 消息 传递 和 流 媒体 平台 ， 具 有 低 
延迟 、 高 性 能 、 可 靠 性 、 万 亿 级 容量 和 灵活 的 可 扩展 性 。 

接 下 来 介绍 RocketMQ (Github 官网 地 址 : https://github.com/apache/rocketmq) 的 Github， 它 
提供 了 多 种 功能 : 

发 布 /订阅 消息 模型 。 

定时 的 消息 传递 。 

按时 间或 偏 移 量 对 消息 进行 追溯 。 

记录 流 媒体 的 中 心 。 

大 数据 集成 。 

可 靠 的 FIFO 和 严格 的 有 序 消息 传递 在 同一 队列 中 。 
高 效 的 推拉 消费 模式 。 

单个 队列 中 的 百 万 级 消息 累积 容量 。 

多 种 消息 传递 协议 ， 如 JMS 和 OpenMessaging。 
灵活 的 分 布 式 横向 扩展 部 署 架 构 。 

Lightning-fast 批 处 理 消息 交换 系统 。 

各 种 消息 过 滤器 机 制 ， 如 SQL 和 Tag。 

Docker 图 像 用 于 隔离 测试 和 云 隔离 集群 。 

功能 丰富 的 管理 仪表 板 ， 用 于 配置 、 指 标 和 监控 。 
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RocketMQ 由 4 部 分 组 成 ， 分 别 是 name servers. brokers, producers 和 consumers， 如 图 9-15 
所 示 。 


NameServer uster 


Broker a — roker 
Discovery Discovery 


NameServerl NameServer? NameServer 


aba u 
Y 


9-15. RocketMQ 组 成 图 


9.3.2 Spring Boot 使 用 RocketMQ 


由 于 官网 已 经 详细 介绍 了 如 何 使 用 RocketMQ, 因此 本 小 节 仅 以 发 送 简单 消息 为 例 介 绍 Spring 
Boot 如 何 使 用 RocketMQ 。 
Spring Boot 使 用 RocketMQ 消息 队列 大 致 分 为 三 步 : 


(1) 加 入 Rocket MO 依赖 。 
(2) 配置 RocketMQ 服务 信息 。 
(3) 编写 生产 者 和 消费 者 。 


1. 加 入 RocketMQ 依赖 
新 建 项 目 ， 在 pom 文件 中 加 入 RocketMQ 依赖 ， 如 代码 清单 9-21 所 示 。 


代码 清单 9-21 RocketMQ 项 目 依赖 代码 


«dependency» 
XgroupId»org.apache.rocketmg«c/groupId» 
XartifactId»rocketmq-client«/artifactlId» 
«version»4.2.0«/version» 

«/dependency» 


2. 配置 RocketMQ 服务 信息 
在 配置 文件 中 加 入 RocketMQ 服务 的 配置 信息 ， 如 代码 清单 9-22 所 示 。 
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代码 清单 9-22 RocketMQ 项 目 配置 文件 


# 消费 者 的 组 名 


apache.rocketmq.consumer.PushConsumer-PushConsumer 


# 生产 者 的 组 名 


apache.rocketmq.producer.producerGroup-Producer 


# NameServer 地 址 
apache.rocketmq.namesrvAddr-localhost:9876 


3. 编写 生产 者 和 消费 者 


这 里 以 发 送 10 条 简单 消息 为 例 ， 创 建 一 个 生产 者 ， 这 里 使 用 的 是 默认 生产 者 
DefaultMQProducer, 在 构建 生产 者 的 时 候 使 用 构造 方法 设置 生产 者 的 组 名 。 使 用 setNamesrvAddr() 
方法 设置 NameServer， 如 果 有 多 个 NameServer， 就 使 用 逗号 分 隔 。 这 里 需要 注意 一 点 ， 生 产 者 对 
象 只 调用 一 次 start 方法 即 可 ， 不 需要 每 次 都 调用 。 在 构建 消息 体 时 设置 topic 和 tags。 完 整 内 容 如 
代码 清单 9-23 所 示 。 


代码 清单 9-23 Rocket MA 项 目 生 产 者 代码 


GComponent 

public class RocketMQSender ( 
GValue("$(apache.rocketmq.producer.producerGroup)") 
private String producerGroup; 
@Value ("$(apache.rocketmq.namesrvAddr)") 
private String namesrvAddr; 
private static final Logger log - LoggerFactory.getLogger 

(RocketMQSender.class); 


public void defaultMQProducer() ( 
DefaultMQProducer producer - new DefaultMQProducer (producerGroup); 
producer.setVipChannelEnabled (false); 
// 指 定 NameServer 地 址 ， 多 个 地 址 以 ; EF 
producer.setNamesrvAddr (namesrvAddr); 
try { 
producer.start(); 
Message message = new Message("TopicTest", "push", " (SHI 
".getBytes()); 
StopWatch stop = new StopWatch(); 
stop.start(); 


for (nte dm On < 0r A 
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SendResult result = producer.send(message, new 
MessageQueueSelector() { 
GOverride 
public MessageQueue select (List«MessageQueue» mqs, Message 
msg, Object arg) ( 
Integer id = (Integer) arg; 
int index - id $ mqs.size(); 
return mqs.get (index); 
H 
),1); 
1og.info(" 发 送 响应 : MsgId:" + result.getMsgId() + "， 发 送 状态 :" + 
result.getSendStatus()); 
} 
stop.stop(); 
-发 送 十 条 消息 耗 时 : " + 


Tog.info("- 
stop.getTotalTimeMillis()); 
) catch (Exception e) ( 
e.printStackTrace(); 
) finally ( 
producer.shutdown(); 


) 


接 下 来 编写 一 个 消费 者 ， 其 中 的 设置 与 生产 者 类 似 ， 这 里 就 不 做 过 多 介绍 了 。 完 整 消费 者 如 
代码 清单 9-24 所 示 。 


代码 清单 9-24 RocketMQ 项 目 


GComponent 

public class RocketMQReceiver { 
GValue ("$(apache.rocketmq.consumer.PushConsumer]") 
private String consumerGroup; 
GValue("$(apache.rocketmq.namesrvAddr)") 
private String namesrvAddr; 
private static final Logger log = LoggerFactory.getLogger 

(RocketMQReceiver.class); 


//ePostCcontruct 是 spring 框架 的 注解 , 在 方法 上 加 该 注解 会 在 项 目 启动 的 时 候 执行 该 方法 ， 
也 可 以 理解 为 在 spring 容器 初始 化 的 时 候 执行 该 方法 
GPostConstruct 
public void defaultMQPushConsumer() { 
// 消 费 者 的 组 名 
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DefaultMQPushConsumer consumer = new DefaultMQPushConsumer 


(consumerGroup); 


// 指 定 NameServer 地 址 ， 多 个 地 址 以 ; WT 
consumer.setNamesrvAddr (namesrvAddr); 
Try i 
// 订 阅 PushTopic F Tag JJ push 的 消息 
consumer.subscribe("TopicTest", "push"); 


// 设 置 Consumer 第 一 次 启动 是 从 队列 头 部 开始 消费 还 是 从 队列 尾部 开始 消费 

// 如 果 非 第 一 次 启动 ， 那 么 按照 上 次 消费 的 位 置 继续 消费 

consumer.setConsumeFromWhere (ConsumeFromWhere. 
CONSUME FROM FIRST OFFSET); 

consumer.registerMessageListener( (MessageListenerConcurrently) 


(list, context) -> { 


try { 
for (MessageExt messageExt : list) ( 
// 输 出 消息 内 容 
log.info("messageExt: " 4 messageExt); 


String messageBody - new String (messageExt.getBody()); 
// 输 出 消息 内 容 
log.info("【 消 费 响 应 】: msgId : " + messageExt.getMsgId() 
+ ", msgBody : " + messageBody) ; 
) 
) catch (Exception e) ( 
e.printStackTrace(); 
// 稍 后 再 试 
return ConsumeConcurrentlyStatus.RECONSUME LATER; 
) 
// 消 费 成 功 
return ConsumeConcurrentlyStatus.CONSUME SUCCESS; 
Da 
consumer.start(); 
) catch (Exception e) ( 
e.printStackTrace(); 


b 


//@PostContruct 是 spring 框 架 的 注解 ,在 方法 上 加 该 注解 会 在 项 目 启动 的 时 候 执行 该 方法 ， 
也 可 以 理解 为 在 spring 容器 初始 化 的 时 候 执行 该 方法 
GPostConstruct 
public void defaultMQPushConsumer2() { 
// 消 费 者 的 组 名 


DefaultMQPushConsumer consumer = new DefaultMQPushConsumer ("aaa"); 


// 指 定 NameServer 地 址 ， 多 个 地 址 以 ; WT 
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consumer.setNamesrvAddr (namesrvAddr); 

try { 
// 订 阅 PushTopic F Tag JN push 的 消息 
consumer.subscribe("TopicTest", "push"); 


// 设 置 Consumer 第 一 次 启动 是 从 队列 头 部 开始 消费 还 是 从 队列 尾部 开始 消费 

// 如 果 非 第 一 次 启动 ， 那 么 按照 上 次 消费 的 位 置 继续 消费 

consumer.setConsumeFromWhere (ConsumeFromWhere. 
CONSUME FROM FIRST OFFSET); 

consumer.registerMessageListener((MessageListenerConcurrently) 


(list, context) -> ( 


try ( 
for (MessageExt messageExt : list) ( 
// 输 出 消息 内 容 
log.info("---- messageExt: " + messageExt); 
String messageBody = new String (messageExt.getBody()); 


// 输 出 消息 内 容 
log.info(" 【消费 响应 】: msgid : " + 
messageExt.getMsgId() + ", msgBody : " + messageBody); 
) 
) catch (Exception e) ( 
e.printStackTrace(); 
// 稍 后 再 试 
return ConsumeConcurrentlyStatus.RECONSUME LATER; 


} 
// 消 费 成 功 
return ConsumeConcurrentlyStatus.CONSUME SUCCESS; 
Da 
consumer.start(); 
) catch (Exception e) ( 
e.printStackTrace(); 


) 


最 后 编写 一 个 RocketMQController 类 来 调用 生产 者 发 送 消息 ， 如 代码 清单 9-25 所 示 。 


代码 清单 9-25 ”RocketMQ 项 目测 试 类 代码 


@RestController 

public class RocketMQController { 
GAutowired 
private RocketMQSender rocketMQSender; 


GGetMapping ("testRocketmq") 
public void testRocketmq()í 
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rocketMOSender.defaultMOProducer(); 


启动 项 目 后 ， 在 浏览 器 中 访问 http://localhost:8080/testRocketmq， 如 图 9-16 所 示 。 


图 9-16 RocketMQ 项 目 控制 台 输出 
RocketMQ 消息 发 送 已 经 成 功 了 。 还 有 很 多 特性 ， 有 具体 可 以 查看 官网 教程 学 习 。 


9.4 消息 队列 对 比 


前 面 学 习 了 常用 的 几 个 消息 队列 ， 本 节 从 以 下 几 方面 对 常用 消息 队列 进行 比较 。 
(1) 关注 度 
首先 我 们 从 百度 搜索 指数 来 看 本 章 介绍 的 3 个 消息 队列 的 关注 情况 ， 如 图 9-17 所 示 。 


me e 


TRADE 


9-17 ”百度 搜索 指数 队列 搜索 对 比 
从 图 9-17 中 可 以 看 到 ，Kafka 消息 队列 远 远 领先 于 RabbitMQ 消息 队列 ，RocketMQ ER. E 
况 RocketMQ 捐献 给 Apache 基金 会 没有 多 久 ， 这 些 老牌 消息 队列 的 关注 度 还 是 很 高 的 。 
接 下 来 ， 我 们 来 看 谷歌 趋势 中 的 搜索 指数 对 比 ， 如 图 9-18 所 示 。 
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图 9-18 谷歌 趋势 消息 队列 搜索 对 比 


与 百度 搜索 相近 ， 在 关注 度 方面 ，Kafka 最 高 ，RabbitMQ 其 次 ，RocketMQ 最 末 。 


(2) RAŠ 

从 成 熟 度 来 看 ， 其 实 对 RocketMQ 并 不 是 十 分 公平 。 毕 竟 和 老牌 消息 队列 相 比 ， 它 还 是 一 个 
初出 茅 庐 的 新 手 。 所 以 就 成 熟 度 来 说 ，Kafka 和 RabbitMQ 已 经 是 成 熟 消息 队列 ， 而 RocketMQ 属 
于 比较 成 熟 的 消息 队列 ， 毕 竟 自 从 开源 给 Apache 基金 会 ， 已 经 发 布 几 个 版 本 了 。 

(3) 社区 活跃 度 

社区 活跃 度 方面 ， 虽 然 国 人 对 RocketMQ 的 呼声 很 高 ， 并 且 已 经 有 大 部 分 企业 准备 使 用 
RocketMQ， 但 是 还 是 无 法 与 老牌 的 消息 队列 社区 比较 。 

(4) 吞吐 量 

吞吐 量 方面 ， 查 看 阿里 中 间 件 博客 对 三 者 的 对 比 ， 结 果 如 图 9-19 所 示 。 


同步 发 送 性 能 对 比 
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120000 
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图 9-19 消息 队列 对 比 图 
在 同步 发 送 场景 中 ，3 个 消息 中 间 件 的 表现 区 别 明显 : 
* Kafka 的 吞吐 量 高 达 17.3w/s， 不 愧 是 高 乔 吐 量 消息 中 间 件 的 行业 老大 。 这 主要 取决 于 它 的 队 
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列 模 式 保证 了 写 磁盘 的 过 程 是 线性 IO， 此 时 broker 磁盘 IO hii. 

© ”RocketMQ 也 表现 不 俗 ， 吞 吐 量 为 11.6ws， 磁 盘 IO %util 已 接近 100%。RocketMQ 的 消息 写 
入 内 存 后 即 返回 ack， 由 单独 的 线程 专门 做 刷 盘 的 操作 ， 所 有 的 消息 均 是 顺序 写 文件 的 。 

* ”RabbitMQ 的 吞吐 量 为 5.95w/s，CPU 资源 消耗 较 高 。 它 支持 AMQP 协议 ， 实 现 非常 重量 级 ， 
为 了 保证 消息 的 可 靠 性 ， 在 吞吐 量 方面 做 了 取舍 。 我 们 还 做 了 RabbitMQ 在 消息 持久 化 场景 
下 的 性 能 测试 ， 吞 吐 量 在 2.6w/s Ex. 


测试 结论 : 在 服务 端 处 理 同步 发 送 的 性 能 上 ，Kafka>RocketMQ>RabbitMQ 。 

(5) 可 靠 性 

可 靠 性 方面 ，RabbitMQ 最 好 ; 其 次 是 RocketMQ; Kafka hizi, 会 有 丢失 消息 的 情况 。 

(6) 事务 

在 事务 方面 ， 只 有 RocketMQ 提供 了 事务 支持 ， 其 他 消息 服务 都 不 提供 事务 支持 。 

(7) 个 人 建议 

如 果 现 有 消息 队列 用 得 很 好 ， 没 有 特别 的 性 能 要 求 ， 不 需要 重复 造 轮子 。 另 外 ， 要 结合 现 有 
场景 来 使 用 ， 不 要 盲目 追求 吞吐 量 等 指标 。 


9.5 小 结 


本 章 对 Spring Boot 使 用 消息 队列 进行 了 介绍 ， 包 括 传统 流行 的 RabbitMQ 消息 队列 、Kafka 
消息 队列 以 及 阿里 巴巴 经 过 多 次 “ 双 11” 测 试 的 RocketMQ 消息 队列 ， 最 后 对 消息 队列 进行 了 对 
比 。 相 信 经 过 学 习 , 读者 会 对 使 用 消息 队列 有 所 了 解 ， 从 而 在 今后 的 工作 中 使 用 消息 队列 时 不 再 迷 
茫 ， 找 到 正确 的 方向 。 
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当 我 们 在 访问 购物 网 站 的 时 候 〈 比 如 淘宝 、 京 东 ) ， 根 据 意 愿 输 入 任意 关键 字 ， 就 可 以 查询 
出 与 关键 字 相 关 的 内 容 ， 实 现 这 项 功能 是 怎么 做 到 的 呢 ? 通常 这 项 功能 是 通过 全 文 检 索 来 实现 的 。 
而 对 于 开源 常用 的 全 文 检索 工具 , 基本 上 大 多 数 企 业 都 会 选用 Apache Solr 或 者 Elasticsearch。 本 章 
将 带领 大 家 学 习 Spring Boot 对 二 者 的 使 用 。 


10.1 使 用 Solr 


10.1.1 Solr 简介 


Solr (官网 地 址 : http://lucene.apache.org/solr/) 是 基于 Apache Lucene 构建 的 流行 、 快 速 、 开 
源 的 企业 搜索 平台 。Solr 是 一 个 独立 的 企业 搜索 服务 器 ， 具 有 类 似 REST 的 API Solr 支持 多 种 类 
型 文件 创建 索引 , IBT JSON, XML, CSV 或 二 进 制 文件 将 文档 放 入 其 中 。 可 以 通过 HTTP GET 
查询 它 并 接收 JSON、XML、CSV 或 二 进 制 结果 。 

Solr 是 Apache 基金 会 的 项 目 ， 在 官网 上 可 以 查看 最 新 版 本 ， 如 图 10-1 所 示 。 

Solr 是 一 个 高 性 能 的 搜索 引擎 ， 其 采用 Java 5 开发 ， 正 是 由 于 它 基 于 Lucene 的 全 文 搜索 服务 
器 ， 因 此 提供 了 比 Lucene 更 为 丰富 的 查询 语言 ， 同 时 实现 了 可 配置 、 可 扩展 并 对 查询 性 能 进行 了 
优化 ， 并 且 提 供 了 一 个 完善 的 功能 管理 界面 ， 是 一 款 非常 优秀 的 全 文 搜索 引擎 。 

通常 来 说 ，Solr 运行 在 Servlet 容器 〈 如 Tomcat, Jetty, WebLogic) 中 ， 提 供 了 独立 的 管理 平 
台 ， 便 于 开发 者 使 用 及 管理 。 
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Solr Feat 


图 10-1 Solr 官网 


10.1.2. Spring Boot 使 用 Solr 


Spring Boot 对 于 Solr 的 使 用 其 实 是 很 简单 的 , 在 Spring Boot 的 starter 中 就 有 Solr 的 依赖 , 直 
接 引 入 即 可 ， 如 代码 清单 10-1 所 示 。 


代码 清单 10-1 Solr 项 目 依赖 代码 


«dependency» 
XgroupId»org.springframework.boot«/groupId» 
X«artifactId»spring-boot-starter-data-solr«/artifactId» 
</dependency> 


接 下 来 ， 需 要 在 配置 文件 中 配置 Solr 服务 器 相关 的 信息 ， 如 代码 清单 10-2 所 示 。 


代码 清单 10-2 Sor 项 目 配置 文件 代码 


## solr 服务 器 地 址 ， 可 以 在 后 面 直接 定义 索引 名 称 ， 如 http://ip: 端 口 /solr/test_solr 
spring.data.solr.host=http://ip: 端 口 /solr 
## solr 索引 名 称 〈 这 个 是 自 定义 的 属性 ， 方 便 使 用 


spring.data.solr.collectionName-test solr 


本 小 节 只 是 对 Spring Boot 结合 Solr 的 使 用 进行 介绍 ， 所 以 没有 创建 过 多 的 类 。 接 下 来 创建 一 
个 实体 类 Goods， 如 代码 清单 10-3 所 示 。 


代码 清单 10-3 Solr WA Goods 实体 类 代码 


public class Goods ( 
private Long id; 
private String goodsName; 
private String goodsIntroduce; 
private Double goodsPrice; 


第 10 章 Spring Boot 的 搜索 之 旅 | 241 


。// 这 里 省 略 set、get、 构 造 函 数 、toString 等 方法 


) 


在 Spring Boot 操作 Solr 的 时 候 ， 所 有 操作 都 是 通过 SolrClient 进行 的 。 接 下 来 我 们 创建 一 个 
SolrController 进行 操作 。 在 类 中 注入 SolrClient (以 下 简称 client) ， 并 且 将 前 面 介绍 的 索引 名 称 自 
定义 属性 定义 进来 ， 如 代码 清单 10-4 所 示 。 


代码 清单 10-4 ”SolrController 类 基础 配置 信息 


GRestController 
public class SolrController ( 


GAutowired 
private SolrClient client; 


G&Value("$(spring.data.solr.collectionName]") 
private String collectionName; 


) 


Controller 基本 上 定义 好 了 。 接 下 来 从 5 个 方面 对 Solr 的 使 用 进行 学 习 。 
1. 保存 或 修改 


在 保存 或 修改 中 ， 开 始 对 传 入 Goods 对 象 的 Id 进行 判断 ， 如 果 不 存在 ， 就 获取 当前 系统 时 间 
凯 作 为 4， 做 保存 操作 ;如 果 存 在 ， 就 做 修改 操作 。 保 存 和 修改 都 是 通过 client.add() 进 行 操作 的 ， 
在 Solr 中 会 判断 Id 是 否 存 在 ， 若 存在 ， 则 修改 ; 若 不 存在 ， 则 新 增 。 对 于 新 增 、 修 改 或 删除 操作 ， 
需要 在 行为 后 使 用 client.commit() 方 法 。 在 commit 方法 中 传 入 操作 索引 名 称 提 交 操 作 , 如 代码 清单 
10-5 所 示 。 


代码 清单 10-5 ”保存 或 修改 方法 代码 


GPostMapping ("saveOrUpdate") 
public String saveOrUpdate ((0RequestBody Goods goods) { 
if(goods.getId() == null)( 
goods.setId(System.currentTimeMillis()); 
} 
try ( 
SolrInputDocument solrInputDocument = new SolrInputDocument (); 
solrInputDocument.setField("id", goods.getlId()); 
solrInputDocument.setField("goodsName", goods.getGoodsName()); 
solrInputDocument.setField("goodsIntroduce", 
goods.getGoodsIntroduce()); 
solrInputDocument.setField("goodsPrice", goods.getGoodsPrice()); 
client.add(collectionName, solrInputDocument); 
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client.commit (collectionName); 
return goods.toString(); 

) catch (Exception e) ( 
e.printStackTrace(); 


) 


return "error"; 


h 


2. 删除 
删除 比较 简单 , 调用 client.deleteById() 方 法 对 指定 Id 的 索引 进行 删除 , 如 代码 清单 10-6 所 示 。 


代码 清单 10-6 ”删除 方法 代码 


GGetMapping ("delete") 
public String delete(String id) ( 
try 
client.deleteById(collectionName,id); 
client.commit (collectionName); 
return id; 
} catch (Exception e) ( 
e.printStackTrace(); 
5 
return "error"; 


5 


3. 删除 所 有 
删除 所 有 是 删除 的 改进 版 ， 使 用 Solr 的 通配符 ， 如 代码 清单 10-7 所 示 。 


代码 清单 10-7 ”删除 所 有 方法 代码 


GGetMapping("deleteAll") 
public String deleteAll()( 
try ( 
client.deleteByQuery (collectionName,"*:;*"); 
client.commit (collectionName); 
return "success"; 
) catch (Exception e) ( 
e.printStackTrace(); 
} 
return "error"; 


} 
4. 根据 Id 查询 
根据 Id 查询 方法 调用 了 client.getById0) 方 法 ， 在 方法 内 传 入 索引 名 称 和 Id， 如 代码 清单 10-8 


所 示 。 
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代码 清单 10-8 ”根据 ld 查询 代码 


GGetMapping ("getGoodsById") 

public String getGoodsById(String id) throws Exception ( 
SolrDocument document - client.getById(collectionName, id); 
return document.toString(); 


j 


5. 


复杂 查询 


复杂 查询 是 使 用 Solr 的 重点 ， 在 讲解 这 个 方法 之 前 ， 先 查看 如 图 10-2 所 示 的 页 面 。 


debugQuery 


图 10-2 ”代码 清单 10-2 Solr 管 理 页 面 


图 10-2 中 的 参数 说 明 如 下 。 


3. 


查询 条 件 介绍 


q 查询 的 关键 字 ， 默 认 值 为 *:*， 代 表 查 询 所 有 ， 也 可 以 指定 条 件 ， 比 如 id:1。 

fq: 过 虑 查询 ， 提 供 一 个 可 选 的 筛选 器 查询 。 返 回 在 q 查 询 结果 中 ， 同 时 符合 fq 筛选 条 件 的 
结果 ， 例 如 q-id:l&fq-goodsPrice:[0 TO 100]， 找 关键 字 id 为 1 并 且 goodsPrice 在 90 ~ 100 
之 间 的 结果 。 

sor: 排序 方式 ， 例 如 sort 的 值 为 id desc， 表 示 按 照 id 降序 排序 。 

start 返回 结果 的 第 几 条 记录 开始 ， 一 般 分 页 用 ， 默 认 从 0 开始 。 

rows: 指定 返回 结果 最 多 有 多 少 条 记录 ， 默 认 值 为 10， 配 合 start 实现 分 页 。 

fl: 指定 返回 字段 ， 用 过 号 或 空格 分 隔 。 注意 字段 区 分 大 小 写 , 例如 , fl AEA id.goodsName. 
df: 默认 的 查询 字段 ， 一 般 需要 开发 人 员 指 定 。 

wt: 指定 输出 格式 ， 有 JSON, XML, Python, Ruby, PHP, CSV. 

indent off: 返回 的 结果 是 否 缩 进 ， 默 认 关闭 ， 用 indent=truelon 开启 ， 一 般 调试 JSON、PHP、 
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PHPS、Ruby 输出 才 有 必要 用 这 个 参数 。 
debugQuery: 设置 返回 结果 是 否 显示 Debug 信息 。 
. Solr 的 检索 运算 符 

“:” ”指定 字段 查 指定 值 ， 如 返回 所 有 值 *:*。 

“9” ”表示 单个 任意 字符 的 通 配 ， 比 如 硬 毛 的 ? 刷 可 以 匹配 硬 毛 的 牙刷 。 

“” ”表示 多 个 任意 字符 的 通 配 ， 比 如 硬 毛 刷 可 以 匹配 硬 毛 的 牙刷 ( 注意 : 不 能 在 检索 的 项 
开始 使 用 * 或 者 ?符号 )。 

“~” ”表示 模糊 检索 ， 比 如 我 们 想 要 检索 到 拼写 类 似 于 administrator 的 项 这 样 写 : 
administrator~， 将 找到 形 如 administrater 和 administratior 的 单词 。 同 时 ， 模 糊 检 索 还 支持 设 
置 相似 度 ， 比 如 我 们 想 要 检索 到 拼写 类 似 于 admin 的 同时 相似 度 0.8 以 上 的 项 可 以 这 样 写 : 
admin~ 0.8， 将 返回 相似 度 在 0.8 以 上 的 记录 。 
AND. || 布尔 操作 符 。 
OR. && 布尔 操作 符 。 
NOT、!、- ”排除 操作 符 ， 不 能 单独 与 项 使 用 构成 查询 。 

“4+” ”存在 操作 符 ， 要 求 符号 “+” 后 的 项 必须 在 文档 相应 的 域 中 存在 。 
() 用 于 构成 子 查询 。 
[] 包含 范围 检索 ， 如 检索 某 时 间 段 的 记录 ， 包 含 头 尾 ，goodsPrice:[90 TO 100]. 
们 ”不 包含 范围 检索 ， 如 检索 菜 时 间 段 的 记录 ， 不 包含 头 尾 ，goodsPrice:{90 TO 100}. 


到 这 里 ， 我 们 对 Solr 的 使 用 已 经 有 了 大 致 的 了 解 ， 这 些 功 能 已 经 可 以 满足 我 们 日 常 的 使 用 。 
接 下 来 介绍 复杂 查询 ， 如 代码 清单 10-9 所 示 。 


代码 清单 10-9 复杂 查询 方法 代码 


@GetMapping ("search") 
public Map<String, Object» search (String keyword) ( 
// 返 回 集合 
MapXString,Object» returnMap = new HashMap(); 
try { 
SolrQuery params - new SolrQuery(); 
// 查 询 条 件 
params.set("q", keyword); 
// 过 滤 条 件 
params.set("fq", "goodsPrice:[100 TO 100000]"); 
// 排 序 
params.addSort("id", SolrQuery.ORDER.asc); 
// 分 页 
// 从 第 几 条 记录 开始 
params.setStart (0); 
// 最 多 返回 多 少 条 记录 
params.setRows (20); 


// 默 认 域 
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params.set("df", "goodsIntroduce"); 
// 只 查询 指定 域 


params.set("fl", "id,goodsName,goodsIntroduce,goodsPrice"); 
// 高 亮 
// 打 开 开 关 
params.setHighlight (true); 
// 指 定 高 亮 域 
params.addHighlightField ("goodsIntroduce"); 
params.addHighlightField ("goodsName"); 
// 设 置 高 亮 前 级 
params.setHighlightSimplePre ("<span style-'color:red'»"); 
// 设 置 高 亮 后 级 
params.setHighlightSimplePost ("</span>"); 
QueryResponse queryResponse = client.query(collectionName, 
params); 
SolrDocumentList results - queryResponse.getResults(); 
// 返 回 行 数 
long numFound = results.getNumFound(); 
// 获 取 高 亮 显示 的 结果 ， 高 亮 显示 的 结果 和 查询 结果 是 分 开放 的 
Map<String, Map<String, List<String>>> highlight = queryResponse. 
getHighlighting(); 
results.forEach (result-»( 
Map map = highlight.get (result.get ("id")); 
result.addField ("goodsNameHH",map.get ("goodsName")); 
result.addField ("goodsIntroduceHH", 
map.get ("goodsIntroduce")); 
Da 
returnMap.put ("numFound", numFound); 
returnMap.put("results", results); 
return returnMap; 
) catch (Exception e) { 
e.printStackTrace(); 
l 
return null; 


$ 


代码 清单 10-9 对 前 面 介绍 的 查询 条 件 进行 了 一 定 的 使 用 ,需要 注意 这 里 使 用 addHighlightField 
对 高 亮 字段 进行 定义 ， 对 高 亮 字段 前 后 都 加 入 span 标签 并 且 样 式 设置 为 红色 ， 当 然 也 可 以 根据 自 
己 的 需求 进行 修改 。 

Spring Boot 对 Solr 的 操作 到 这 里 基本 上 就 结束 了 。 由 于 篇 幅 所 限 ， 就 不 给 出 相关 测试 了 ， 感 
兴趣 的 读者 可 以 自行 测试 。 


246 | Spring Boot 2 实战 之 旅 


10.2 ”使 用 Elasticsearch 


10.2.1 Elasticsearch 简介 


Elasticsearch 〈 官 网 地 址 : https://www.elastic.co/cn/products/elasticsearch) 是 一 个 分 布 式 可 扩展 
的 实时 搜索 和 分 析 引 擎 。Elasticsearch 由 Java 开发 ， 其 底层 基于 Lucene 的 搜索 服务 器 ， 对 外 提供 
f RESTful Web 接口 。 

在 美国 时 间 2018 年 10 月 5H, Elasticsearch 在 美国 纽约 证 券 交 易 所 上 市 , 在 上 市 当天 , Elastic 
公司 在 官网 发 布 了 公开 信 ， 如 图 10-3 所 示 。 


die elastic prosuas coud services Customers — as 


Sign up for product updates! 


图 10-3 Elastic 官网 公开 信 
Elastic 公司 成 立 于 2012 年 ， 正 是 由 于 Elasticsearch 而 闻名 ， 该 公司 还 有 很 多 优秀 的 产品 ， 如 
分 布 式 日 志 解 决 方案 ELK (Elasticsearch、Logstash、Kibana) , Beats 等 。 
目前 ，Elasticsearch 被 很 多 大 型 组 织 使 用 ， 比 如 我 们 常用 的 代码 托管 网 站 Github， 笔 者 认为 有 
效 解决 问题 的 IT 问答 网 站 Stack. Overflow 以 及 维基 百科 都 在 使 用 它 。 在 国内 ， 许 多 电 商 公司 的 商 
品 搜索 和 管理 使 用 得 很 多 ，Elasticsearch 已 经 成 为 很 多 公司 解决 搜索 问题 的 必 备 良药 。 


10.2.2 Spring Boot 使 用 Elasticsearch 


Spring Boot 提供 了 使 用 Elasticsearch 的 starter。 新 建 项 目 ， 在 项 目 中 加 入 Elasticsearch 依赖 ， 
如 代码 清单 10-10 所 示 。 


第 10 章 Spring Boot 的 搜索 之 旅 | 247 


代码 清单 10-10 Elasticsearch 项 目 依赖 代码 


<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-data-elasticsearch</artifactId> 
</dependency> 


接 下 来 ， 在 配置 文件 中 配置 Elasticsearch 服务 器 地 址 。 由 于 样 例 demo 使 用 的 Elasticsearch 是 
单 节点 的 ， 因 此 只 需要 配置 Elasticsearch 地 址 即 可 ， 如 代码 清单 10-11 所 示 。 


代码 清单 10-11 Elasticsearch 项 目 配置 文件 


spring.data.elasticsearch.cluster-nodes = 127.0.0.1:9300 


10.2.3 ”使 用 Elasticsearch Repository 进行 操作 


Elsticsearch 提供 了 像 JPA 一 样 操作 的 Elasticsearch Repository， 其 操作 与 JPA 使 用 类 似 ， 这 里 
展示 几 个 简单 的 使 用 方法 ， 如 代码 清单 10-12 所 示 。 


代码 清单 10-12 BaseOperationController 类 代码 


GRestController 
public class BaseOperationController ( 


GAutowired 
private ArticleRepository articleRepository; 


GPostMapping ("saveOrUpdate") 
public String saveOrUpdate(G8RequestBody Article article)( 
if(article.getId()--null)( 
article.setId(System.currentTimeMillis ()); 
b 
articleRepository.save (article); 
return "保存 成 功 "; 
i; 


GGetMapping ("delete") 

public String delete(Long id)( 
articleRepository.deleteById (id); 
return "删除 成 功 "7 

H 


GGetMapping("findById") 

public Article findById(long id)( 
Article article - articleRepository.findById(id).get(); 
return article; 
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GGetMapping("findAll") 


public Iterable«Article» findAll()( 
return articleRepository.findAll(); 


) 


是 不 是 和 JPA 很 相似 ? 感 兴趣 的 读者 可 以 研究 一 下 。 


10.24. ”使 用 Elasticsearch Template 进行 操作 


Spring Boot 的 spring-boot-starter-data-elasticsearch 还 提供 了 Elasticsearch Template， 这 个 模板 
类 可 以 进行 查询 之 类 的 操作 ， 还 可 以 进行 一 些 配置 相关 的 操作 ， 如 创建 和 删除 索引 、 设 置 Mapping 
等 。 这 里 分 别 展示 创建 索引 、 删 除 索引 、 判 断 是 否 存 在 此 索引 、 判 断 索 引 中 是 否 存在 当前 type、 获 
取 Mapping 和 获取 Setting 操作 ， 如 代码 清单 10-13 所 示 。 


代码 清单 10-13 ElasticOperationCi 


GRestController 
public class ElasticOperationControler ( 


GAutowired 
private ElasticsearchTemplate elasticsearchTemplate; 


GGetMapping("createIndex") 
public boolean createIndex(String indexName)( 

return elasticsearchTemplate.createIndex(indexName); 
b 


GGetMapping("deleteIndex") 
public boolean deleteIndex(String indexName)( 

return elasticsearchTemplate.deleteIndex(indexName); 
b 


GGetMapping("indexIsExist") 
public boolean indexIsExist(String indexName)( 

return elasticsearchTemplate.indexExists (indexName); 
} 


GGetMapping("typeIsExist") 

public boolean typeIsExist(String indexName,String type){ 
return elasticsearchTemplate.typeExists (indexName,type); 

b 


GGetMapping ("getMapping") 
public Map getMapping(String indexName, String type)í 


return elasticsearchTemplate.getMapping (indexName, type); 
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GGetMapping("getSetting") 
public Map getSetting(String indexName)( 
return elasticsearchTemplate.getSetting (indexName); 
b 
) 


上 面 的 内 容 都 比较 简单 ， 所 以 笔者 只 是 一 笔 带 过 ， 接 下 来 是 本 节 的 重点 内 容 。 


10.25 RESH 


本 小 节 先 带领 大 家 熟悉 一 下 Elasticsearch 的 几 种 操作 ， 然 后 进行 几 个 查询 来 总 结 学 习 的 内 容 。 

非 聚 合 查询 大 致 分 为 6 种 : 单 匹配 查询 、 多 匹配 查询 、 全 匹配 查询 、 模 糊 查询 、 范 围 查 询 和 
组 合 查询 。 

1. 单 匹 配 查 询 


在 单 匹 配 查询 中 ， 分 为 两 种 场景 ， 分 别 是 使 用 分 词 器 和 不 使 用 分 词 器 (分 词 器 是 将 用 户 输入 
的 一 段 文本 分 隔 成 符合 逻辑 的 多 个 词语 ， 后 续 会 专门 讲解 ) 。 设 置 单 匹配 不 分 词 查询 条 件 如 代码 清 
单 10-14 所 示 。 


代码 清单 10-14 ”使 用 termQuery 创建 QueryBuilder 代码 


QueryBuilder queryBuilder-QueryBuilders.termQuery ("fieldName", 
"fieldValue"); 


设置 单 匹配 分 词 查询 条 件 如 代码 清单 10-15 所 示 。 


代码 清单 10-15 ”使 用 matchQuery 创建 QueryBuilder 代码 


QueryBuilder queryBuilder = QueryBuilders.matchQuery ("fieldName", 
"fieldValue"); 


例如 ， QueryBuilder queryBuilder-QueryBuilders.termQuery("articleName", "test"); 是 指 在 
articleName 中 包含 test 即 可 被 查询 到 。 


2. 多 匹配 查询 


多 匹配 查询 与 单 匹配 查询 的 使 用 方式 类 似 ， 包 含 使 用 分 词 器 和 不 使 用 分 词 器 。 设 置 多 匹配 不 
分 词 查询 条 件 如 代码 清单 10-16 所 示 。 


代码 清单 10-16 ”使 用 termsQuery 创建 QueryBuilder 代码 


QueryBuilder queryBuilder=QueryBuilders.termsQuery ("fieldName", 
"fieldlValuel","fieldlValue2..."); 
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设置 多 匹配 分 词 查询 条 件 如 代码 清单 10-17 所 示 。 


代码 清单 10-17 使 用 multiMatchQuery 创建 QueryBuilder 代码 


QueryBuilder queryBuilder= QueryBuilders.multiMatchQuery ("fieldlValue", 
"fieldNamel", "fieldName2", "fieldName3"); 


例如 ，QueryBuilder queryBuilder-QueryBuilders.termsQuery("articleName", "test", "article"); JH 
在 articleName 中 既 包含 test KWA article 才 会 被 查询 到 。 


3. 全 匹配 查询 


全 匹配 查询 属于 多 匹配 查询 的 特殊 情况 ， 通 俗 地 理解 ， 就 是 没有 设置 任何 查询 条 件 。 这 里 将 
这 种 情况 与 多 匹配 查询 分 开 来 讲 ， 一 般 设 置 全 匹配 查询 条 件 如 代码 清单 10-18 所 示 。 


代码 清单 10-18 ”使 用 matchAllQuery 创建 QueryBuilder 代码 


QueryBuilder queryBuilder-QueryBuilders.matchAllQuery(); 


4. 模糊 查询 
模糊 查询 其 实 和 SQL 中 的 模糊 很 类 似 ， 大 致 分 为 如 下 几 种 : 


CD 左右 模糊 查询 : 比如 QueryBuilders.queryStringQuery(" field Value").field("fieldName"); o 

(2) 相似 内 容 的 查询 : 如 果 不 指 定 filedName， 就 默认 为 全 部 ， 常 用 在 相似 内 容 的 推荐 上 ， 
比如 QueryBuilders.moreLikeThisQuery(new String[] ("fieldName"]).addLikeText("field Value"); . 

(3) 前 级 查询 : 如 果 字 段 没 分 词 ， 就 匹配 整个 字段 前 级 ， 比 如 QueryBuilders.prefixQuery 
("fieldName","fieldValue"); o 

(4) 分 词 模糊 查询 : 通过 增加 包 zziness 模糊 属性 来 查询 ， 如 能 够 匹配 hotelName 为 tel 前 或 
后 加 一 个 字母 的 文档 ，fuzziness 的 含义 是 检索 的 term 前 后 增加 或 减少 n 个 单词 的 匹配 查询 ， 比 如 
QueryBuilders.fuzzyQuery("fieldName", "fieldValue").fuzziness(Fuzziness.ONE); o 

(5) 通配符 查询 : 支持 * 任 意 字 符 串 ， 任 意 一 个 字符 ， 通 常 使 用 fielaValue 后 拼接 通配符 ， 比 
如 QueryBuilders.wildcardQuery("fieldName","con*"); o 

5. 范围 查询 

顾名思义 ， 范 围 查 询 就 是 给 定 范围 区 间 查 询 ， 分 为 以 下 几 种 : 

e 闭 区 间 查 询 ， 如 QueryBuilder queryBuilder = QueryBuilders.rangeQuery("fieldName"). 
from("fieldValue1").to("fieldValue2"); 。 

e 开 区 间 查 询 ， 如 QueryBuilder queryBuilder = QueryBuilders.rangeQuery("fieldName"). 
from("fieldValue1").to("fieldValue2").includeUpper(false).includeLower(false);， 默 认 值 为 true, 
表示 包含 边界 值 。 

e 大 于 查询 ， 如 QueryBuilder queryBuilder = QueryBuilders.rangeQuery("fieldName"). 
gt(" fieldValue");. 
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e 大 于 等 于 查询 ， 如 QueryBuilder queryBuilder = QueryBuilders.rangeQuery("fieldName"). 
gte("fieldValue");. 

© 小 于 查询 e QueryBuilder queryBuilder = QueryBuilders.rangeQuery("fieldName"). 
It("fieldValue");. 

e 小 于 等 于 查询 ， 如 QueryBuilder queryBuilder = QueryBuilders.rangeQuery("fieldName"). 
Ite("fieldValue");. 


6. 组 合 查询 
组 合 查询 其 实 就 是 将 上 述 几 种 场景 组 合 起 来 ， 与 SQL 中 的 查询 条 件 一 样 ， 分 为 如 下 三 种 : 


文档 必须 完全 匹配 条 件 ， 相 当 于 SQL 中 的 AND 条 件 ， 如 QueryBuilders.boolQuery().must(); . 
文档 必须 完全 不 匹配 条 件 ， 相 当 于 SQL 中 的 NOT 条 件 ， 如 QueryBuilders.boolQuery(). 
mustNot(); . 

e 文档 匹配 条 件 ， 多 个 条 件 满足 一 个 即 可 ， 相 当 于 SQL 中 的 OR 条 件 ， 如 QueryBuilders. 
boolQuery().should();. 


10.26 ”聚合 查询 


(D 统计 某 个 字段 的 数量 
ValueCountBuilder vcb- AggregationBuilders.count("count uid").field("uid"); 
(2) 去 重 统计 某 个 字段 的 数量 (有 少量 误差 ) 


CardinalityBuilder cb= 
AggregationBuilders.cardinality("distinct count uid").field("uid"); 


G) 聚合 过 滤 


FilterAggregationBuilder fab= AggregationBuilders.filter("uid filter"). 
filter (QueryBuilders.queryStringQuery ("uid:001")); 


(4) 按 某 个 字段 分 组 


TermsBuilder tb= AggregationBuilders.terms ("group name").field("name"); 


C5) RAI 

SumBuilder sumBuilder- AggregationBuilders.sum("sum price").field("price"); 
C6) 求 平均 

AvgBuilder ab= AggregationBuilders.avg("avg price").field("price"); 


CD 求 最 大 值 


MaxBuilder mb= AggregationBuilders.max("max price").field("price"); 
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(8) 求 最 小 值 
MinBuilder min= AggregationBuilders.min("min price").field("price"); 
C9) 按 日 期 间隔 分 组 


DateHistogramBuilder dhb= AggregationBuilders.dateHistogram("dh") . 
field("date"); 


(100. 获取 聚合 里 面 的 结果 

TopHitsBuilder thb- AggregationBuilders.topHits("top result"); 

aD KENA 

NestedBuilder nb- AggregationBuilders.nested("negsted path").path("quests"); 


a2) RERE 


AggregationBuilders.reverseNested("res negsted").path("kps "); 


10.2.7 ”复杂 查询 练习 


结合 案例 内 容 ， 笔 者 准备 了 5 个 从 简单 到 复杂 的 查询 ， 分 别 说 明 如 下 : 

场景 一 : 不 分 词 查 询 

查询 articleContent 带 有 “你 好 ”或 者 articleName 带 有 “你 好 ”的 文章 列表 , 并 且 按 照 readCount 
倒叙 排序 ， 如 代码 清单 10-19 所 示 。 


//http://localhost:8080/query10?keyword= 你 好 
GGetMapping("queryl") 
public List«Article» queryl(String keyword) ( 
BoolQueryBuilder boolQueryBuilder - QueryBuilders.boolQuery(); 
boolQueryBuilder.should (QueryBuilders.termQuery ("articleContent", 
keyword)); 
boolQueryBuilder.should (QueryBuilders.termQuery ("articleName", 
keyword)); 
FieldSortBuilder fieldSortBuilder - SortBuilders.fieldSort 
("readCount").order (SortOrder.DESC); 
NativeSearchQueryBuilder nativeSearchQueryBuilder - new 
NativeSearchQueryBuilder(); 
nativeSearchQueryBuilder.withQuery (boolQueryBuilder); 
nativeSearchQueryBuilder.withSort (fieldSortBuilder); 
NativeSearchQuery nativeSearchQuery - 
nativeSearchQueryBuilder.build(); 
Page«Article» page = articleRepository.search(nativeSearchQuery); 
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if (page !- null) ( 

return page.getContent (); 
) else ( 

return null; 


n 


场景 二 : 不 分 词 查询 


查询 articleContent 带 有 “我 们 ”或 者 “你 好 ”并 且 authorAge 在 20 岁 以 下 的 文章 列表 ， 并 且 
按照 readCount 倒叙 排序 ， 如 代码 清单 10-20 所 示 。 


代码 清单 10-20 H 示例 代码 


//http://1localhost:8080/query11?keyword= 你 好 ,我 们 
@GetMapping ("query2") 
public List<Article> query2(String... keyword) { 
BoolQueryBuilder boolQueryBuilder - QueryBuilders.boolQuery(); 
boolQueryBuilder.must (QueryBuilders.termsQuery ("articleContent", 
keyword)); 
boolQueryBuilder.must (QueryBuilders.rangeQuery 
("authorAge").1t(20)); 
FieldSortBuilder fieldSortBuilder - SortBuilders.fieldSort 
("readCount").order(SortOrder.DESC); 
NativeSearchQueryBuilder nativeSearchQueryBuilder - new 
NativeSearchQueryBuilder(); 
nativeSearchQueryBuilder.withQuery (boolQueryBuilder); 
nativeSearchQueryBuilder.withSort (fieldSortBuilder); 
NativeSearchQuery nativeSearchQuery - 
nativeSearchQueryBuilder.build(); 
Page«Article» page = articleRepository.search (nativeSearchQuery); 
if (page !- null) ( 
return page.getContent(); 
) else ( 
return null; 


5 


景 三 : 分 词 查询 


经 过 分 词 ， 查 询 articleContent 带 有 “你 好 节日 ”一 词 分 词 后 的 文章 列表 ， 并 且 按 照 authorAge 
倒叙 排序 ， 如 代码 清 代 10-21 所 示 。 


代码 清单 10-21 场景 三 示例 代码 


//http://1localhost:8080/query12?keyword= 你 好 节日 
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GGetMapping ("query3") 
public List«Article» query3 (String keyword) ( 
BoolQueryBuilder boolQueryBuilder = QueryBuilders.boolQuery(); 
boolQueryBuilder.should (QueryBuilders.matchQuery ("articleContent", 
keyword)); 
FieldSortBuilder fieldSortBuilder - 
SortBuilders.fieldSort ("authorAge").order(SortOrder.DESC); 
NativeSearchQueryBuilder nativeSearchQueryBuilder - new 
NativeSearchQueryBuilder(); 
nativeSearchQueryBuilder.withQuery (boolQueryBuilder); 
nativeSearchQueryBuilder.withSort (fieldSortBuilder); 
NativeSearchQuery nativeSearchQuery - 
nativeSearchQueryBuilder.build(); 
Page«Article» page = articleRepository.search (nativeSearchQuery); 
if (page !- null) ( 
return page.getContent () ; 
) else ( 
return null; 


) 
HRA: 分 页 分 词 查询 


经 过 分 词 ， 查 询 articleContent 带 有 “你 好 节日 ”一 词 分 词 后 的 文章 列表 ， 并 且 按 照 authorAge 
倒叙 排序 ， 如 代码 清单 10-22 所 示 。 


代码 清单 10-22 ”场景 四 示例 代码 


//http://localhost:8080/query13?keyword= 你 好 节日 spageNum=1&pageSize=5 
@GetMapping ("query4") 
public Page<Article> query4(String keyword, Integer pageNum, Integer 
pageSize) ( 
BoolQueryBuilder boolQueryBuilder - QueryBuilders.boolQuery(); 
boolQueryBuilder.should (QueryBuilders.matchQuery ("articleContent", 
keyword)); 
FieldSortBuilder fieldSortBuilder - 
SortBuilders.fieldSort ("authorAge").order (SortOrder.DESC); 
PageRequest pageRequest - new PageRequest (pageNum, pageSize); 
NativeSearchQueryBuilder nativeSearchQueryBuilder - new 
NativeSearchQueryBuilder(); 
nativeSearchQueryBuilder.withQuery (boolQueryBuilder); 
nativeSearchQueryBuilder.withSort (fieldSortBuilder); 
nativeSearchQueryBuilder.withPageable (pageRequest) ; 
NativeSearchQuery nativeSearchQuery - nativeSearchQueryBuilder. 


build(); 
Page«Article» page = articleRepository.search (nativeSearchQuery); 
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if (page != null) ( 
return page; 

} else { 
return null; 


H 
场景 五 : 分 页 分 词 查询 


这 个 场景 需要 提前 安装 分 词 器 (这 里 使 用 的 是 ik 分 词 器 ) ， 经 过 分 词 ， 查 询 articleContent 带 
有 “你 好 节日 ”一 词 分 词 后 的 文章 列表 ， 并 且 按 照 authorAge 倒叙 排序 ， 并 且 对 匹配 的 词语 设置 高 
亮 ， 如 代码 清单 10-23 所 示 。 


清单 10-23 ”场景 五 示例 代 


//http://1localhost:8080/query14?keyword= 你 好 节日 
&pageNum-l&pageSize-5&fieldNames-articleContent,articleName 

GGetMapping ("query5") 

public Map«String, Object» query5 (String keyword, Integer pageNum, Integer 
pageSize, String... fieldNames) ( 


// 定 义 返回 的 map 

Map<String, Object> returnMap = new HashMap«String,Object»(); 

// 构 建 请 求 构建 器 ， 设 置 查询 索引 

SearchRequestBuilder builder = elasticsearchTemplate. 
getClient().prepareSearch ("testes"); 


// 构 建 查询 构建 器 ， 设 置 分 词 器 〈 如 果 没 设置 ， 就 使 用 默认 设置 7 
QueryBuilder matchQuery = QueryBuilders.multiMatchQuery (keyword, 
fieldNames).analyzer("ik max word"); 


// 构 建 高 亮 构建 器 

HighlightBuilder highlightBuilder = new HighlightBuilder(). 
field("*").requireFieldMatch(false); 

highlightBuilder.preTags("«span style=\"color:red\">"); 

highlightBuilder.postTags ("</span>"); 


// 将 高 亮 构建 器 、 查 询 构建 器 、 分 页 参数 设置 到 请 求 构 建 器 内 
builder.highlighter (highlightBuilder); 
builder.setQuery (matchQuery); 
builder.setFrom((pageNum - 1) * pageSize); 
builder.setSize(pageNum * pageSize); 
builder.setSize (pageSize); 


// 执 行 搜索 ， 返 回 搜索 响应 信息 
SearchResponse searchResponse = builder.get(); 
SearchHits searchHits - searchResponse.getHits(); 
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// 总 命中 数 
long total = searchHits.getTotalHits(); 
returnMap.put("count", total); 


// 将 高 亮 字段 封装 到 返回 map 
SearchHit[] hits = searchHits.getHits(); 
List«MapcString,Object»» list = new ArrayList«»(); 
Map«String,Object» map; 
for(SearchHit searchHit : hits)( 
map = new HashMap<>(); 
map.put ("data",searchHit.getSourceAsMap()); 
Map«String,Object» hitMap = new HashMap<>(); 
searchHit.getHighlightFields().forEach((k,v) -> ( 
String hight - ""; 
for (Text text : v.getFragments())í( 
hight += text.string(); 
) 
hitMap.put (v.getName () ,hight) ; 
n; 
map.put ("highlight",hitMap); 
list.add (map); 
) 
returnMap.put("dataList", list); 
return returnMap; 


10.3 ”搜索 引擎 对 比 


前 两 节 分 别 对 当今 开源 流行 的 两 大 搜索 引擎 框架 做 了 一 定 介绍 ， 并 且 结合 Spring Boot 框架 对 
二 者 进行 了 使 用 ， 究 竟 哪 个 框架 更 适合 呢 ? 结合 笔者 的 经 验 ， 本 节 对 二 者 进行 比较 。 


103.1. 技术 背景 


Solr 于 2006 年 捐献 给 Apache， 成 为 Apache 的 孵化 项 目 ， 一 年 后 Solr RIE, AR f 1.2 
版 本 ， 并 且 成 为 Lucene 的 子 项 目 ， 从 1.4.x 版 本 以 后 ， 为 了 保持 和 Lucene 同步 ，Solr 直接 进入 3.0 
版 本 。 官 网 列 出 了 Solr 的 版 本 (地 址 为 http://archive.apache.org/dist/lucene/solr/)， 如 图 10-4 所 示 ， 
在 Apache 开源 基金 会 的 强大 背景 下 ，Solr 的 更 新 还 是 很 频繁 的 。 

Elasticsearch 是 2012 年 6 月 开始 开源 的 ， 对 于 Elasticsearch 有 这 样 一 个 故事 : 

伦敦 的 公寓 内 ，Shay Banon 正在 忙 着 寻找 工作 ， 而 他 的 妻子 正在 蓝 带 (Le Cordon Bleu) Xf 
学 校 学 习 厨 艺 。 在 空闲 时 间 ， 他 开始 编写 搜索 引擎 来 帮助 妻子 管理 越 来 越 丰富 的 菜谱 。 
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10-4. Solr 官网 版 本 


他 的 首 个 迭代 版 本 叫 作 Compass。 第 二 个 和 迭代 版 本 就 是 Elasticsearch (基于 Apache Lucene FF 
发 ) 。 他 将 Elasticsearch 作为 开源 产品 发 布 给 公众 ， 并 创建 了 Elasticsearch IRC 通道 ， 接 着 就 静 待 
用 户 出 现 了 。 

公众 反响 十 分 强烈 。 用 户 自然 而 然 地 喜欢 上 了 这 个 软件 。 由 于 使 用 量 急速 梦 升 ， 这 个 软件 开 
始 有 了 自己 的 社区 ， 并 引起 了 人 们 的 高 度 关注 ， 尤 其 引发 了 Steven Schuurman, Uri Boness 和 
Simon Willnauer 的 浓厚 兴趣 。 他 们 4 人 最 终 共同 组 建 了 一 家 搜索 公司 。 

在 Elastic 官网 (地址 : https//www.elastic.co/cn/about/history-of-elasticsearch ) 上 记载 着 
Elasticsearch 辉煌 的 发 展 史 。 在 2018 年 美国 时 间 10 月 5 号 ，Elasticsearch 在 美国 上 市 ， 在 上 市 到 
现在 的 几 个 月 内 ,官网 (地址: https://www.elastic.co/downloads/past-releases ) 不 断 更 新 版 本 ， 如 图 
10-5 所 示 。 


“je elastic 产品 n" Ns WP TM va [9996] Q o 
mem 


Past Releases 


Winlogbeat OSS 7.0.0-alpha2 D See Release Notes ( Goncioss 
December 20,2018 


Winlogbeat 7.0.0-alpha2 > See Release notes [Scio] 


图 10-5 Elasticsearch 官网 版 本 


综 上 所 述 ， 对 于 二 者 的 技术 背景 ， 笔 者 认为 可 以 打 个 平手 ， 毕 竟 两 个 搜索 引擎 框架 背后 都 是 
非常 成 熟 的 公司 ， 并 且 相 信 在 未 来 对 二 者 的 关注 会 持续 保持 高 涨 。 
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10.3.2 ”热度 比较 


在 百度 搜索 指数 中 ， 开 发 人 员 近 些 年 对 Elasticsearch 的 关注 程度 及 搜索 指数 更 高 一 些 ，2011 
年 初 到 2018 年 底 的 百度 搜索 指数 如 图 10-6 所 示 。 


mama 2011-01-01 ~ 2018-12-23 EX o. PCHÉÁE + 
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Wohn 
I saana sanoa tan mm want mame 
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图 10-6 百度 搜索 指数 


在 谷歌 搜索 指数 中 ， 也 是 Elasticsearch 在 近 些 年 的 关注 度 更 胜 一 筹 ，2004 年 初 到 2018 年 底 ， 
谷歌 搜索 指数 如 图 10-7 所 示 。 
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图 10-7 谷歌 搜索 指数 
综 上 所 述 ， 对 于 二 者 的 热度 比较 ，Elasticsearch 更 胜 一 筹 。 
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10.3.3 ”集群 部 署 


在 部 署 方 面 ， 只 要 下 载 Solr 可 以 运行 在 Web 服务 器 上 的 可 执行 文件 即 可 ; 在 集群 方面 ， 需 要 
使 用 Zookeeper 进行 集群 管理 。 

Elasticsearch 单 节点 安装 比较 简单 ， 下 载 对 应 版 本 的 压缩 文件 ， 解 压 即 可 使 用 。 在 集群 方面 ， 
Elasticsearch 有 一 个 内 置 的 类 似 ZooKeeper 的 名 为 Zen 的 组 件 ， 通 过 内 部 的 协调 机 制 来 维护 集群 状 
态 。 在 集群 的 时 候 需 要 注意 各 项 配置 ， 稍 不 注意 就 可 能 遇 到 一 些 “ 坑 ”。 

综 上 所 述 ， 对 于 集群 部 署 方 面 ， 由 于 笔者 在 部 署 Elasticsearch 集群 时 踩 过 一 些 “ 坑 ”， 因 此 个 
人 认为 Solr 稍微 简单 一 些 。 


10.8.4 数据 格式 


Solr 支持 多 种 数据 格式 , 如 JSON, XML, CSV 等 , 但 是 Elasticsearch 仅 支 持 JSON 文件 格式 ， 
在 数据 格式 方面 ，Solr 完胜 。 


10.8.5 ”效率 


这 个 观点 是 开发 者 对 二 者 选 型 最 具 决 定性 的 一 点 ， 当 对 已 经 创建 好 索引 的 文件 进行 查询 时 ， 
Solr 的 效率 明显 高 于 Elasticsearch。 但 是 当 查 询 实 时 数据 时 ， 由 于 Sor 创建 索引 时 会 产生 IO 阻塞 ， 
因此 查询 性 能 很 差 ， 在 这 种 情况 下 ，Elasticsearch 的 效率 明显 高 于 Solr。 

综 上 所 述 ， 如 果 业 务 场景 需要 实时 搜索 ， 那 么 建议 选择 Elasticsearch; 如 果 是 对 已 有 数据 进行 
查询 ， 并 且 改 变 不 大 ， 那 么 建议 使 用 Solr。 


10.4 小 结 


本 章 对 常用 的 两 种 搜索 引擎 进行 了 介绍 ， 并 且 基 于 Spring Boot 对 二 者 进行 了 一 定 的 使 用 。 相 
信 经 过 本 章 的 学 习 ， 读 者 会 对 二 者 的 使 用 有 一 定 的 认 知 ， 进 而 在 实际 项 目 中 应 用 。 


Spring Boot 的 小 彩蛋 


本 章 学 习 Spring Boot 的 一 些 扩展 功能 ， 有 些 功 能 可 能 在 实际 工作 中 没有 用 处 ， 但 是 有 些 功 能 
在 实际 工作 中 使 用 得 非常 多 ， 需 要 我 们 密切 关注 。 


11.4 修改 启动 Banner 


Spring Boot 应 用 程序 的 启动 Banner 是 一 大 亮点 ， 本 节 带 领 大 家 学 习 如 何 修改 启动 Banner。 


11.1.1 启动 Banner 介绍 


在 第 一 次 接触 Spring Boot 应 用 的 时 候 ， 除 了 其 性 能 、 配 置 上 的 亮点 外 ， 更 吸引 笔者 注意 的 就 
是 启动 Banner， 如 图 11-1 所 示 。 


11-1 Spring Boot 启动 Banner 
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Spring Boot 应 用 程序 在 初始 化 的 时 候 使 用 SpringApplication 类 的 run 方法 ， 如 代码 清单 11-1 
所 示 。 


Spring Boot 应 用 启动 时 初始 化 的 方 


public ConfigurableApplicationContext run(String... args) ( 
StopWatch stopWatch = new StopWatch(); 
stopWatch.start(); 
ConfigurableApplicationContext context - null; 
Collection«SpringBootExceptionReporter» exceptionReporters = new 
ArrayList«»(); 
configureHeadlessProperty(); 
SpringApplicationRunListeners listeners - getRunListeners (args); 
listeners.starting(); 
try í 
ApplicationArguments applicationArguments = new 
DefaultApplicationArguments (args); 
ConfigurableEnvironment environment - 
prepareEnvironment (listeners, applicationArguments); 
configureIgnoreBeanInfo (environment); 
Banner printedBanner - printBanner (environment); 
context = createApplicationContext () ; 
exceptionReporters = getSpringFactoriesInstances( 
SpringBootExceptionReporter.class, 
new Class[] ( ConfigurableApplicationContext.class }, 
context); 
prepareContext (context, environment, listeners, 
applicationArguments, printedBanner); 
refreshContext (context); 
afterRefresh(context, applicationArguments); 
stopWatch.stop(); 
if (this.logStartupInfo) ( 
new StartupInfoLogger (this.mainApplicationClass) 
-logStarted(getApplicationLog(), stopWatch); 
} 
listeners.started(context); 
callRunners (context, applicationArguments); 
H 
catch (Throwable ex) ( 
handleRunFailure(context, ex, exceptionReporters, listeners); 
throw new IllegalStateException (ex); 


try t 
listeners.running (context); 
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H 

catch (Throwable ex) ( 
handleRunFailure(context, ex, exceptionReporters, null); 
throw new IllegalStateException (ex); 

H 

return context; 


ji 


从 源 代码 中 可 以 看 出 ， 启 动 Banner 调用 了 当前 类 中 的 printBanner 方法 。 在 该 方法 中 ， 首 先 在 
Classpath 内 依次 寻找 banner.gif, banner.jpg, banner.png 和 banner.txt 文件 ， 如 果 找 到 ， 就 使 用 ;如 
果 没 找到 ， 就 使 用 默认 的 Spring Boot Banner。 其 中 ，printBanner() 方 法 如 代码 清单 11-2 所 示 。 


单 11-2. Spring Boot 应 用 启动 时 调用 printBanner 


private Banner printBanner(ConfigurableEnvironment environment) { 
if (this.bannerMode -- Banner.Mode.OFF) ( 
return null; 
) 
ResourceLoader resourceLoader - (this.resourceLoader !- null ? 
this.resourceLoader : new DefaultResourceLoader (getClassLoader())); 
SpringApplicationBannerPrinter bannerPrinter - new 
SpringApplicationBannerPrinter(resourceLoader, this.banner); 
if (this.bannerMode -- Mode.LOG) ( 
return bannerPrinter.print(environment, this.mainApplicationClass, 
logger); 
b 
return bannerPrinter.print(environment, this.mainApplicationClass, 
System.out); 
} 


刚刚 说 到 ， 默 认 会 打印 Spring Boot Banner， 这 个 类 通过 将 Spring 的 Logo 写成 一 个 字符 串 数 
组 ， 然 后 通过 String Builder 打印 出 来 ， 实 现 启动 Banner 的 打印 。 其 中 SpringBootBanner 类 的 完整 
代码 如 代码 清单 11-3 所 示 。 


代码 清单 11-3 Spring Boot 应 用 -Spring Boot Banner 类 完整 代码 


class SpringBootBanner implements Banner ( 


private static final String[] BANNER - ( "", 
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private static final String SPRING BOOT = " :: Spring Boot :: "7 
private static final int STRAP LINE SIZE = 42; 


GOverride 
public void printBanner (Environment environment, Class<?> sourceClass, 
PrintStream printStream) ( 
for (String line : BANNER) ( 
printStream.println (line); 
H 
String version - SpringBootVersion.getVersion(); 
version = (version !- null ? " (v" + version + ")" 3 ""); 
StringBuilder padding = new StringBuilder(); 
while (padding.length() « STRAP LINE SIZE 
- (version.length() * SPRING BOOT.length())) ( 
padding.append(" "); 


l 


printStream.println(AnsiOutput.toString(AnsiColor.GREEN, 
SPRING BOOT, AnsiColor.DEFAULT, padding.toString(), 
AnsiStyle.FAINT, version)); 

printStream.println(); 


11.1.2. az) Banner 修改 


前 面 已 经 介绍 了 ， 修 改 启动 Banner 就 是 在 scr/main/resources 文件 夹 下 创建 一 个 对 应 的 Banner 
文件 。 这 里 创建 一 个 banner.txt 文件 ， 启 动 后 如 图 11-2 所 示 。 


图 11-2 修改 后 的 Spring Boot 应 用 程序 启动 Banner 


另外 ，Spring Boot 还 提供 了 几 个 配置 来 设置 Banner， 分 别 说 明 如 下 。 


S(AnsiColorBRIGHT CYAN]: 设置 Banner 字体 颜色 。 

${AnsiBackground.BRIGHT_CYAN}: 设 置 Banner 背景 颜色 。 

S(AnsiStyle. UNDERLINE}: 设置 字体 样式 。 

${application.version}: 对 应 显示 配置 文件 中 application.version 的 属性 配置 ， 主 要 用 于 配置 版 
本 号 。 

${application.formatted-version}: 用 于 格式 化 版 本 号 ， 默 认 在 版 本 号 后 面 加 V。 
$(spring-boot.version): Spring Boot 的 版 本 号 。 
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* Síspring-boot.formatted-version! : 用 于 格式 化 Spring Boot 版 本 号 ， 默 认 格 式 如 
(v2.0.3.RELEASE). 


当然 ， 可 能 有 人 不 喜欢 这 个 Banner, Spring Boot 提供 了 关闭 Banner 的 开关 。 在 启动 类 设置 
setBannerMode(Banner.Mode.OFF)， 即 可 关闭 开关 ， 如 代码 清单 11-4 所 示 。 


代码 清单 11-4 Spring Boot 应 用 -启动 类 关闭 Banner 代码 


@SpringBootApplication 
public class ChapterlOlApplication { 
public static void main(String[] args) ( 
SpringApplication springApplication - new SpringApplication 
(Chapterl0lApplication.class); 
springApplication.setBannerMode (Banner.Mode.OFF); 


springApplication.run (args); 


) 


在 Spring Boot 2.0 以 后 ， 支 持 使 用 动态 GIF 当 作 Banner， 比 如 在 src/mian/resources 下 放 入 
banner.gif， 启 动 项 目 时 会 优先 播放 这 个 GIF， 如 果 同 时 存在 banner.gif 和 banner.txt， 则 会 优先 播放 
GIF， 再 打印 TXT 文件 中 的 内 容 。 感 兴趣 的 读者 可 以 自己 创建 漂亮 的 启动 Banner， 动 手 试 试 吧 ! 


11.2 ”使 用 LomBok 让 编程 更 简单 


开发 过 程 中 会 创建 非常 多 的 实体 类 ， 反 复 使 用 IDE 对 实体 类 的 Set 方法 、Get 方法 进行 创建 十 
分 麻烦 。 本 节 带 领 大 家 学 习 使 用 Lombok 让 编程 变 得 简单 。 


11.2.1 什么 是 LomBok 


Project LomBok 〈 宫 网 地 址 : https://www.projectlombok.org/) 是 一 个 简化 编程 的 Java 库 ， 通 过 
使 用 它 可 以 利用 注解 的 形式 省 去 写 Set 方法 、Get 方法 、 构 造 函 数 、equals 方法 、toString 方法 。 举 
个 例子 ， 使 用 User 类 时 ， 如 果 没 有 使 用 LomBok， 每 新 增 一 个 属性 ， 就 需要 反复 写 Set 方法 、Get 
方法 ， 修 改 构造 函数 ， 等 等 。 但 是 使 用 LomBok 后 ， 一 个 @getter 就 可 以 给 所 有 属性 添加 Get 方法 ， 
甚至 使 用 @Data 方法 可 以 为 JavaBean 自动 注入 所 有 属性 的 Set 方法 、Get 方法 以 及 构造 函数 。 同 时 ， 
LomBok 还 提供 了 对 日 志 打 印 的 方法 ， 从 而 可 以 大 大 地 简化 元 余 的 JavaBean 代码 。 


11.2.2 IntelliJ IDEA 安装 Lombok 插件 


在 IntelliJ IDEA 中 安装 Lombok 插件 有 两 种 方式 ， 第 一 种 是 在 Intelli) IDEA 中 直接 安装 插件 ， 
如 图 11-3 所 示 。 
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* Tibok Plugin js 


IntelliJ Lombok plugin 


图 11-3. IntelliJ IDEA 内 安装 Lombok 插件 


第 二 种 是 通过 IntelliJ IDEA 官网 插件 页 (http://plugins.jetbrains.com/〉 下 载 ， 然 后 放 入 IntelliJ 
IDEA 安装 目录 的 plugins 文件 夹 内 。 两 种 方式 无 论 选择 哪 种 ， 安 装 后 都 需要 重启 Intelli) IDEA. 


11.2.3 ”如 何 使 用 LomBok 


在 Spring Boot 应 用 程序 中 使 用 Lombok 非常 简单 新 建 项 目 , 在 项 目 中 引入 lombok 依赖 文件 ， 
如 代码 清单 11-5 所 示 。 


代码 清单 11-5 Spring Boot-Lombok 项 目 - 引 入 lombok 依赖 代码 


«dependency» 
XgroupId»org.projectlombok«/groupId» 
X«artifactId»lombok«/artifactId» 
«version»1.16.20«/version» 

«/dependency» 


接 下 来 在 对 应 实体 类 中 加 入 注解 即 可 实现 诸如 Set 77i. Get 方法 的 自动 生成 ， 代 码 这 里 不 作 
示 。 下 面 对 Lombok 注解 进行 介绍 。 

e val 用 在 局 部 变量 前 面 ， 相 当 于 将 变量 声明 为 final. 

* @NonNull: 为 方法 参数 增加 这 个 注解 会 自动 对 参数 进行 是 否 为 空 的 校 验 ， 如 果 为 空 ， 就 会 抛 
出 NullPointerException 异常 。 

* @CIeanUp: 自动 管理 资源 ， 用 在 局 部 变量 之 前 ， 在 当前 变量 范围 内 ， 即 将 执行 完毕 退出 之 
会 自动 清理 资源 ， 自 动 生成 try-finally 这 样 的 代码 来 关闭 流 。 

© @Setter/@Getter: 用 在 属性 上 之 后 自动 为 其 生成 Set 和 Get 方法 。 


& 
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© (ToString: 在 类 上 使 用 ,使 用 后 自动 生成 toString 方法 。 默 认 情 况 下 ， 它 会 按 顺序 打印 类 的 
名 称 以 及 每 个 字段 ， 并 以 喜 号 分 隔 。 并 且 提 供 了 exclude 属性 和 callSuper 属性 ， 其 中 可 以 使 
用 exclude 属性 排除 属性 ， 比 如 @ToString(exclude="name") 可 以 排除 name 属性 ; callSuper Æ 
性 设置 为 True 后 可 以 将 父 类 的 所 有 toString 输出 。 

* @EqualsAndHashcode: 用 在 类 上 ， 自 动 从 对 和 象 的 字段 中 生成 hashCode 和 equals 的 实现 。 

* (üNoArgsConstructor: 用 在 类 上 ， 自 动 生成 一 个 没有 参数 的 构造 函数 方法 。 

* @RequiredArgsConstructor: 用 在 类 上 ， 自 动 生成 一 个 包含 常量 (final) 和 标识 了 @NotNull 
的 变量 的 构造 方法 。 

* (AllArgsConstructor: 用 在 类 上 ， 为 所 有 字段 生成 带 有 一 个 参数 的 构造 方法 。 

* (Data: 用 在 类 上 ， 其 实 @Data 是 一 个 组 合 注解 ， 其 包含 @ToString、@EqualsAndHashCode、 
@Getter、@Setter、@RequiredArgsConstructor 注解 的 特征 。 简 单 来 说 ，@Data 注解 可 以 满足 
一 个 JavaBean 的 基本 需求 ， 对 于 POJO 类 十 分 有 用 。 

* @Vau: 用 在 类 上 ， 是 @Data 的 不 可 变形 式 ， 相 当 于 为 属性 添加 final 声明 ， 只 提供 getter 
方法 ， 而 不 提供 setter 方法 。 

* (Builder: 用 在 类 、 构 造 器 、 方 法 上 ， 提 供 复杂 的 builderAPIs。 

© @SneakyThrows: 用 在 方法 上 ， 自 动 为 方法 加 入 try, catch 检查 异常 。 

* (üSynchronized: 用 在 方法 上 ， 将 方法 声明 为 同步 的 ， 并 自动 加 锁 ， 而 锁 对 象 是 一 个 私有 的 属 
性 $lock 或 $SLOCK。Java 中 Syncronized 关键 字 无 论 是 加 在 方法 上 还 是 对 象 上 ， 所 获取 的 锁 都 
是 对 象 。 

* @Log: 支持 各 种 logger 对 象 , 使 用 时 用 对 应 的 注解 ,如 @Log4j、@Log4j2、@CommonsLog、 
GLog. G/SIf4j. @XSIfj. 


11.8 ”邮件 发 送 


对 于 开发 者 来 说 ， 邮 件 发 送 是 一 个 老生 常 谈 的 问题 了 。 比 如 系统 出 现 异 常 ， 定 期 向 维护 人 员 
发 送 报告 、 定 期 的 总 结 等 ， 需 要 使 用 邮件 发 送 的 时 候 非常 多 。 

在 Spring Boot 框架 中 ， 为 我 们 提供 了 便捷 使 用 的 starter 来 实现 邮件 发 送 功能 。 本 节 将 学 习 在 
Spring Boot 中 使 用 邮件 发 送 。 


11.3.1 在 Spring Boot 中 使 用 邮件 发 送 


在 Spring Boot 应 用 中 , 想 要 使 用 邮件 发 送 功能 ,就 要 在 pom 文件 中 加 入 spring-boot-starter-mail 
依赖 ， 如 代码 清单 11-6 所 示 。 


代码 清单 11-6 Spring Boot-Mail 项 目 依赖 代码 


<dependency> 
XgroupId»org.springframework.boot«/groupId» 
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<artifactId>spring-boot-starter-mail</artifactId> 


</dependency> 


11.3.2 ”基础 配置 信息 


接 下 来 需要 在 配置 文件 中 配置 邮箱 信息 ， 如 发 送 邮 箱 服务 器 地 址 、 邮 箱 用 户 名 、 邮 箱 密码 ， 
如 果 使 用 的 邮箱 含有 独立 密码 ,就 需要 在 密码 处 填写 独立 密码 。 这 里 以 阿里 云 邮箱 为 例 ， 配置 如 代 
码 清单 11-7 所 示 。 


代码 清单 11-7 Spring Boot-Mail 项 目 配置 文件 代码 


## 邮 箱 服务 器 地 址 

##QQ smtp.qq.com 

##sina smtp.sina.cn 

##aliyun smtp.aliyun.com 

##163 smtp.163.com 
spring.mail.host=smtp.aliyun.com 

## 邮 箱 用 户 名 
spring.mail.username=dalaoyang@aliyun.com 
## 邮 箱 密码 (注意 :qq 邮箱 应 该 使 用 独立 密码 ， 去 qq 邮箱 设置 中 获取 》 
spring.mail.password-****** 

## 编 码 格式 
spring.mail.default-encoding-UTF-8 


## 发 送 邮件 地 址 
mail.fromMail.sender=dalaoyang@aliyun.com 
## 接 收 邮件 地 址 


mail.fromMail.receiver-yangyang8dalaoyang.cn 


这 里 以 Controller iH] 7309], Spring Boot 使 用 邮件 发 送 都 是 操作 JavaMailSender 类 来 实现 的 ， 
所 以 我 们 创建 一 个 MailController 类 ， 在 类 中 注入 发 送 邮件 关键 的 类 JavaMailSender， 并 且 使 用 
sender 和 receiver 分 别 接收 配置 文件 配置 的 发 送 者 和 接收 者 ， 如 代码 清单 11-8 所 示 。 


代码 清单 11-8 Spring Boot-Mail 项 目测 试 类 基础 代码 


GRestController 
public class MailController ( 


private final Logger logger = LoggerFactory.getLogger(this.getClass()); 


GQValue("$(mail.fromMail.sender)") 
private String sender; 


(Value ("$(mail.fromMail.receiver)") 
private String receiver; 
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// 内 容 接 下 来 详细 介绍 


11.3.3 ”文本 邮件 发 送 


邮件 发 送 中 最 简单 的 就 是 发 送 文 本 邮件 。 使 用 JavaMailSender 发 送 文本 邮件 很 简单 ， 创 建 一 
个 SimpleMailMessage 实体 ， 在 实体 类 中 设置 以 下 几 个 参数 即 可 。 
from: 邮件 发 送 地 址 。 
to: 邮件 接收 者 ， 可 以 是 多 个 ， 使 用 去 号 分 隔 。 
Subject: 邮件 的 主题 。 
text: 邮件 的 正文 内 容 。 


了 解 如 何 使 用 后 ， 接 下 来 在 MailController 中 创建 一 个 simpleMail 方法 测试 文本 邮件 发 送 ， 如 
代码 清单 11-9 所 示 。 


代码 清单 11-9 Spring Boot-Mail 项 目 发 送 普 通 文 本 代码 


Q@GetMapping ("simpleMail") 
public void simpleMail(){ 
String subject = "文本 邮件 "; 
String text = "文本 邮件 正文 内 容 "7 
SimpleMailMessage simpleMailMessage = new SimpleMailMessage(); 
simpleMailMessage.setFrom(sender); 
simpleMailMessage.setTo (receiver); 
simpleMailMessage.setSubject (subject); 
simpleMailMessage.setText (text); 
try t 
javaMailSender.send(simpleMailMessage); 
logger.info (" 发 送 文本 邮件 成 功 ! "); 
) catch (Exception e) ( 
logger.error ("发 送 文本 邮件 时 发 生 异 常 ! ", e); 
} 
} 


启动 项 目 ， 发 送 HTTP 请 求 http://localhost:8080/simpleMail， 稍 等 一 下 查看 邮件 ， 可 以 看 到 如 
图 11-4 所 示 的 内 容 。 


bredel] 


文本 邮件 正文 内 容 


1-4 发 送 文本 邮件 
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收 到 这 个 邮件 后 ， 文 本 邮件 就 发 送 完成 了 。 


11.3.4 网 页 邮件 发 送 


网 页 邮件 发 送 是 指 发 送 一 段 符 合 HTML 语法 的 字符 串 。 使 用 网 页 邮件 发 送 的 时 候 需 要 操作 
MimeMessage 实体 ， 在 实体 类 中 设置 以 下 几 个 参数 。 
from: 邮件 发 送 地 址 。 
to: 邮件 接收 者 ， 可 以 是 多 个 ， 使 用 过 号 分 隔 。 
Subject: 邮件 的 主题 。 
text: 第 一 个 参数 拼接 好 的 HTML 字符 串 ， 第 二 个 参数 为 true。 


在 MailController 中 创建 htmlMail 方法 来 测试 发 送 网 页 邮件 ， 如 代码 清单 11-10 所 示 。 


代码 清单 11-10 Spring Boot-Mail 项 目 发 送 网 页 邮件 代码 


GGetMapping ("/htmlMail") 
public void htmlMail() ( 
String subject = "网 页 邮件 "7 
String content="<html>\n" + 
"<body>\n" + 
" ”<h3> 这 是 一 封 Html 邮件 !</h3>\n" + 
"</body>\n" + 
"</html>"; 
MimeMessage message = javaMailSender.createMimeMessage () 7 
try i 
MimeMessageHelper helper = new MimeMessageHelper (message, true); 
helper .setFrom (sender) ; 
helper .setTo (receiver); 
helper.setSubject (subject); 
helper.setText(content, true); 
javaMailSender.send (message); 
1ogger.info(" 发 送 网 页 邮件 成 功 ! "); 
) catch (Exception e) ( 
logger.error ("发 送 网 页 邮件 时 发 生 异 常 ! ", e); 
} 
ji 


启动 项 目 ， 发 送 HTTP 请 求 localhost:8080/htmlMail， 查 看 邮件 ， 可 以 看 到 如 图 11-5 所 示 的 
内 容 。 


azti oone 


这 是 一 封 Html 邮 件 ! 


11-5 ”发 送 网 页 邮件 
收 到 这 个 邮件 后 ， 网 页 邮件 就 发 送 完 成 了 。 


11.3.5 ”附件 邮件 发 送 


发 送 邮件 的 时 候 经 常会 遇 到 附件 。 接 下 来 ， 我 们 学 习 如 何 发 送 附 件 邮 件 ， 与 发 送 网 页 邮件 使 
用 的 实体 一 样 ， 只 不 过 利用 addAttachment 方法 将 文件 添加 进来 。 举 个 例子 ， 笔 者 要 将 电脑 桌面 上 
的 settings.xml 文件 发 送 到 邮件 中 , 发 送 多 个 邮件 就 多 次 调用 addAttachment 方法 ,如 代码 清单 11-11 
所 示 。 


代码 清单 11-11 Spring Boot-Mail 项 目 发 送 附件 邮件 代码 


GRequestMapping ("/filesMail") 
public void filesMail() ( 
String subject = "附件 邮件 "; 
String text = "附件 邮件 正文 内 容 "7 
String filePath-"/Users/dalaoyang/Desktop/settings.xml"; 
MimeMessage message - javaMailSender.createMimeMessage(); 
trey t 
MimeMessageHelper helper = new MimeMessageHelper (message, true); 
helper.setFrom(sender); 
helper.setTo (receiver); 
helper.setSubject (subject); 
helper.setText(text, true); 
FileSystemResource file - new FileSystemResource (new File(filePath)); 
String fileName - 
filePath.substring(filePath.lastIndexOf (File.separator)); 
helper.addAttachment (fileName, file); 
javaMailSender.send (message); 
1ogger.info(" 发 送 附件 邮件 成 功 ! "); 
) catch (Exception e) ( 


logger.error ("发 送 附 件 邮件 时 发 生 异 常 ! ", e); 


启动 项 目 , 发 送 HTTP 请 求 localhost:8080/filesMail, 查看 邮件 , 可 以 看 到 如 图 11-6 所 示 的 内 容 。 
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图 11-6 发送 附件 邮件 
收 到 这 个 邮件 后 ， 附 件 邮件 就 发 送 完成 了 。 


11.3.6 赃 入 静态 资源 邮件 发 送 


嵌入 静态 资源 邮件 其 实 是 网 页 邮件 的 改进 版 本 ， 通 俗 来 说 ， 就 在 网 页 邮件 的 图 片 标签 中 嵌入 
图 片 。 举 个 例子 ， 笔 者 要 将 电脑 桌面 上 的 mailjpg 图 片 嵌 入 邮件 中 ， 若 需要 嵌入 多 个 图 片 ， 则 直接 
在 页 面 拼接 多 个 图 片 标签 即 可 ， 如 代码 清单 11-12 所 示 。 


青 单 11-12 Spring Boot-Mail 项 目 源 邮 件 代码 


GRequestMapping ("/inlineResourceMail") 
public void inlineResourceMail() ( 
String Id - "test001"; 
String subject = " 芍 入 静态 资源 邮件 "; 
StringBuilder stringBuilder = new StringBuilder(); 
stringBuilder.append("<html><body> 这 是 有 图 片 的 邮件 : ") ; 
stringBuilder.append("«img src-'cid:" + Id + "' >"); 
stringBuilder.append("«/body»«/html»"); 
String content - stringBuilder.toString(); 
String imgPath - "/Users/dalaoyang/Desktop/mail.jpg"; 
MimeMessage message = javaMailSender.createMimeMessage(); 
KENA 
MimeMessageHelper helper = new MimeMessageHelper (message, true); 
helper.setFrom(sender); 
helper.setTo (receiver); 
helper.setSubject (subject); 
helper.setText(content, true); 
FileSystemResource res - new FileSystemResource (new File(imgPath)); 
helper.addInline(Id, res); 
javaMailSender.send (message) ; 


logger.info ("嵌入 静态 资源 邮件 成 功 ! ") 7 
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) catch (Exception e) ( 
logger.error(" 发 送 嵌 入 静态 资源 邮件 时 发 生 异 常 ! "，e) 7 
b 
) 


启动 项 目 ， 发 送 HTTP 请 求 localhost:8080/inlineResourceMail， 查 看 邮件 ， 可 以 看 到 如 图 11-7 
所 示 的 内 容 。 


WABABE 
发 件 人 


m4 |becme 


这 是 有 图 片 的 好 件 


图 11-7 ”发 送 嵌 入 静态 资源 邮件 


收 到 这 个 邮件 后 ， 嵌 入 静态 资源 邮件 就 发 送 完成 了 。 邮 件 发 送 大 致 就 这 几 种 类 型 ， 读 者 可 以 
根据 实际 情况 结合 使 用 。 


11.4 三 “器 ”的 使 用 


在 实际 应 用 开发 中 ， 可 能 存在 一 些 与 业务 无 关 ， 但 是 起 着 重要 作用 的 功能 ， 比 如 在 程序 中 校 
验 用 户 是 否 登 录 、 是 否 有 权限 去 做 这 件 事 、 进 行 统一 的 日 志 打印 、 异 常 处 理 等 。 这 时 就 可 以 利用 强 
大 的 三 “器 ”来 实现 这 些 功能 。 

可 能 很 多 人 已 经 猜 到 了 ， 笔 者 所 指 的 三 “器 ”就 是 耳熟能详 的 过 滤器 、 拦 截 器 和 监听 器 。 本 
节 带 领 大 家 学 习 在 Spring Boot 中 使 用 过 滤器 、 拦 截 器 和 监听 器 。 


11.4.4. 过 滤器 
本 小 节 学 习 三 “器 ”的 第 一 个 主 解 一 一 过 滤器 。 
1. 过 滤器 介绍 


过 滤器 的 英文 名 称 为 Filter， 是 Servlet 技术 中 最 实用 的 技术 。 如 同 它 的 名 字 一 样 ， 过 滤器 是 处 
于 客户 端 与 服务 器 资源 文件 之 间 的 一 道 过 滤 网 , 帮助 我 们 过 滤 一 些 不 符合 要 求 的 请 求 。 通常 它 被 用 
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TE Session 校 验 ， 判 断 用 户 权限 ， 如 果 不 符合 设 定 条 件 ， 就 会 被 拦截 到 特殊 的 地 址 或 者 给 予 特殊 的 
响应 。 

2. 使 用 过 滤器 

使 用 过 滤器 很 简单 ， 只 需要 实现 Filter 类 ， 然 后 重 写 它 的 3 个 方法 即 可 。 

e init 方 法 : 在 容器 中 创建 当前 过 滤器 的 时 候 自 动 调用 这 个 方法 。 

* destory 方法 : 在 容器 中 销毁 当前 过 滤器 的 时 候 自动 调用 这 个 方法 。 

e doFilter 方法 : 这 个 方法 有 3 个 参数 ， 分 别 是 ServletRequest、ServletResponse 和 FilterChain。 

可 以 从 参数 中 获取 HttpServletRequest 和 HttpServletResponse 对 象 进行 相应 的 处 理 操作 。 


接 下 来 ， 我 们 直接 创建 一 个 过 滤器 MyFilter。 这 里 做 一 些 URL 的 拦截 ， 如 果 符 合 条 件 ， 就 正 
常 跳 转 ， 如 果 不 符合 条 件 ， 就 拦截 到 /online 请 求 中 。MyFilter 完整 内 容 如 代码 清单 11-13 所 示 。 


代码 清单 11-13 Spring Boot- 过 滤器 项 目 代码 


Public class MyFilter implements Filter { 


GOverride 
public void doFilter(ServletRequest request, ServletResponse response, 
FilterChain chain) throws IOException, ServletException ( 
System.out.println("MyFilter 被 调用 ") 7 
HttpServletRequest httpServletRequest = (HttpServletRequest) request; 
HttpServletResponseWrapper wrapper = new HttpServletResponseWrapper 
((HttpServletResponse) response); 
// 只 有 符合 条 件 的 可 以 直接 请 求 ， 不 符合 的 跳 转 到 /online 请 求 中 
String requestUri = httpServletRequest.getRequestURI () ; 
System.out .println ("请 求 地 址 是 : "+requestUri) ; 


if (requestUri.indexOf("/addSession") != -1 
|| requestUri.indexOf ("/removeSession") != -1 
|| requestUri.indexOf("/online") != -1 
|| requestUri.indexOf("/favicon.ico") != -1) { 


chain.doFilter(request, response); 
else { 
wrapper.sendRedirect ("/online"); 


GOverride 

public void init(FilterConfig filterConfig) throws ServletException ( 
// 在 服务 启动 时 初始 化 
System.out.println ("初始 化 拦截 器 ") ; 
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QGOverride 
public void destroy() ( 
// 在 服务 关闭 时 销毁 
System.out .println (" 销 毁 拦截 器 ") ; 


11.4.2 ”拦截 器 


本 小 节 学 习 三 “器 ”的 第 二 个 主角 一 一 拦截 器 。 


1. 


拦截 器 介绍 


Java 中 的 拦截 器 是 动态 拦截 action 调用 的 对 象 ， 然 后 提供 了 可 以 在 action 执行 前 后 增加 一 些 
操作 ， 也 可 以 在 action 执行 前 停止 操作 。 其 实 拦截 器 也 可 以 做 和 过 滤器 同样 的 操作 ， 以 下 是 拦截 器 
的 常用 场景 。 


2; 


登录 认证 : 在 一 些 简单 应 用 中 ， 可 能 会 通过 拦截 器 来 验证 用 户 的 登录 状态 ， 如 果 没 有 登录 或 
者 登录 失效 ， 就 会 给 用 户 一 个 友好 的 提示 或 者 返回 登录 页 面 。 

记录 系统 日 志 : 在 Web 应 用 中 ,通常 需要 记录 用 户 的 请 求 信息 ， 比 如 请 求 的 IP、 方 法 执行 时 
常 等 ， 通 过 这 些 记 录 可 以 监控 系统 的 状况 ， 以 便于 对 系统 进行 信息 监控 、 信 息 统 计 、 计 算 PV 
(Page View ) 和 性 能 调 优等 。 

通用 处 理 : 在 应 用 程序 中 可 能 存在 所 有 方法 都 要 返回 的 信息 ， 这 时 可 以 使 用 拦截 器 来 实现 ， 
省 去 每 个 方法 宛 余 重复 的 代码 实现 。 


使 用 拦截 器 


这 里 以 使 用 Spring 拦截 器 为 例 ， 在 类 上 需要 实现 HandlerInterceptor 类 ， 并 且 重 写 类 中 的 3 个 
方法 ， 分 别 是 : 


preHandle 在 业务 处 理 器 处 理 请 求 之 前 被 调用 ， 返 回 值 是 boolean 值 ， 如 果 返 回 true, È 
行 下 一 步 操作 ; 若 返 回 false， 则 证 明 不 符合 拦截 条 件 。 在 失败 的 时 候 不 会 包含 任何 响应 ， 此 
时 需要 调用 对 应 的 response 返回 对 应 响应 。 

postHandle ”在 业务 处 理 器 处 理 请 求 执行 完成 后 、 生 成 视图 前 执行 。 这 个 方法 可 以 通过 方法 
参数 ModelAndView 对 视图 进行 处 理 ， 当 然 ModelAndView 也 可 以 设置 为 null。 
afterCompletion ”在 DispatcherServlet 完全 处 理 请 求 后 被 调用 ， 通 常用 于 记录 消耗 时 间 ， 也 可 
以 进行 一 些 资源 处 理 操作 。 


接 下 来 ， 创 建 一 个 自 定义 拦截 器 MyInterceptor， 我 们 用 这 个 拦截 器 打印 请 求 的 耗 时 ， 并 且 判 
断 当 前 的 浏览 器 是 否 存在 Session. Mylnterceptor 完整 内 容 如 代码 清单 11-14 所 示 。 
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GComponent 
public class MyInterceptor implements HandlerInterceptor | 


GOverride 
public boolean preHandle (HttpServletRequest request, HttpServletResponse 
response, Object handler) throws Exception { 
System.out.println("preHandle 被 调用 ") ; 
request.setAttribute("startTime", System.currentTimeMillis()); 


return true; 


GOverride 
public void postHandle(HttpServletRequest request, HttpServletResponse 


response, Object handler, ModelAndView modelAndView) throws Exception ( 
System.out.println("postHandle 被 调用 ") ; 
HttpSession session = request.getSession(); 
String name - (String) session.getAttribute ("name"); 
if("dalaoyang".equals (name) ) ( 
System.out.println("-------------------- 当前 浏览 器 存在 session"); 


GOverride 
public void afterCompletion(HttpServletRequest request, 
HttpServletResponse response, Object handler, Exception ex) throws Exception ( 
System.out.println("afterCompletion 被 调用 ") ; 
long startTime = (Long) request.getAttribute ("startTime"); 
System out printlp E ELLE 请 求 耗 时 : " + 
(System.currentTimeMillis() - startTime)); 
} 


11.4.3 ”监听 器 


本 小 节 学 习 三 “器 ”的 最 后 一 个 主角 一 
1. 监听 器 介绍 
监听 器 通常 用 于 监听 Web 应 用 中 对 象 的 创建 、 销 毁 等 动作 的 发 生 ， 同 时 对 监听 的 情况 做 出 相 
应 的 处 理 ， 最 常用 于 统计 网 站 的 在 线 人 数 、 访 问 量 等 信息 。 
监听 器 大 致 分 为 以 下 几 种 。 
* ServletContextListener: 用 来 监听 ServletContext 属性 的 操作 ， 比 如 新 增 、 人 修改、 删除 。 


监听 器 。 
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© HitpSessionListener: 用 来 监听 Web 应 用 中 的 Session 对 象 ， 通 常用 于 统计 在 线 情况 。 
© ServletRequestListener: 用 来 监听 Request 对 象 的 属性 操作 。 


2. 使 用 监听 器 


使 用 监听 器 的 话 ， 只 需要 在 类 中 实现 对 应 功能 的 监听 器 对 象 ， 如 本 文 使 用 的 
HttpSessionListener。 下 面 以 监听 Session 信息 为 例 统 计 在 线 人 数 。 新 建 一 个 MyHttpSessionListener 
类 ， 实 现 HttpSessionListener 类 ， 在 类 中 定义 一 个 全 局 变量 online， 当 创建 Session 时 ，online 的 数 
量 加 1; 当 销 毁 Session 时 ，online 的 数量 减 1。MyHttpSessionListener 完整 内 容 如 代码 清单 11-15 
所 示 。 


代码 清单 11-15 Spring Boot- 监 听 器 项 目 代码 


public class MyHttpSessionListener implements HttpSessionListener ( 
public static int online - 0; 


GOverride 

public void sessionCreated(HttpSessionEvent se) { 
System.out.println("sessionCreated 被 调用 ") ; 
online ++; 


GOverride 

public void sessionDestroyed(HttpSessionEvent se) ( 
System.out .println("sessionDestroyed 被 调用 ") ; 
online --; 


11.4.4 Spring Boot 引用 三 “器 ” 


过 滤器 、 监 听 器 和 拦截 器 我 们 已 经 创建 好 了 ， 但 是 还 不 能 引用 。 接 下 来 我 们 修改 Spring Boot 
启动 类 ， 在 类 中 通过 注入 Bean 的 方式 引用 三 者 。 启 动 类 完整 内 容 如 代码 清单 11-16 所 示 〈 也 可 以 
使 用 其 他 方法 引用 ， 比 如 创建 一 个 配置 类 统一 管理 ) 。 


代码 清单 11-16 Spring Boot- 引 用 三 器 代码 


GSpringBootApplication 
public class Chapterll4Application implements WebMvcConfigurer { 


public static void main(String[] args) ( 
SpringApplication.run(Chapterll4Application.class, args); 
5 
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GAutowired 
private MyInterceptor myInterceptor; 


GOverride 
public void addInterceptors(InterceptorRegistry registry) { 
registry.addInterceptor (myInterceptor); 


GBean 

public FilterRegistrationBean filterRegist() ( 
FilterRegistrationBean frBean - new FilterRegistrationBean(); 
frBean.setFilter(new MyFilter()); 
frBean.addUrlPatterns ("/*"); 
return frBean; 


GBean 
public ServletListenerRegistrationBean listenerRegist() ( 
ServletListenerRegistrationBean srb - new 
ServletListenerRegistrationBean(); 
srb.setListener(new MyHttpSessionListener()); 
return srb; 


11.4.5 测试 


接 下 来 ， 使 用 Controller 对 过 滤器 、 拦 截 器 和 监听 器 进行 测试 ， 在 类 中 我 们 只 需要 创建 3 个 方 
法 ， 分 别 说 明 如 下 。 

* addSession: 负责 新 增 一 个 Session。 

* removeSession: 负责 销毁 当前 浏览 器 的 Session. 

* online 查看 在 线 人 数 。 


完整 内 容 如 代码 清单 11-17 所 示 。 


代码 清单 11-17 Spring Boot- 三 “器 ”项 目测 试 代码 


GRestController 
public class TestController ( 


GGetMapping("/addSession") 
public String addSession(HttpServletRequest request) ( 
HttpSession session - request.getSession(); 
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session.setAttribute ("name", "dalaoyang"); 
return "当前 在 线 人 数 " + MyHttpSessionListener.online; 
F 


@GetMapping ("/removeSession") 

public String removeSession(HttpServletRequest request) { 
HttpSession session = request.getSession(); 
session.invalidate(); 
return "当前 在 线 人 数 "  MyHttpSessionListener.online; 


G(GGetMapping("/online") 
public String online() { 

return "当前 在 线 人 数 : " + MyHttpSessionListener.online + "A"; 
b 


) 


启动 项 目 ， 测 试 步骤 如 下 : 

使 用 浏览 器 访问 http:/localhost:8080/online， 可 以 看 到 浏览 器 提示 “当前 在 线 人 数 0 人” (E 
截 器 成 功 ) 。 

UD 多 次 使 用 浏览 器 访问 http://localhost:8080/addSession， 可 以 看 到 浏览 器 提示 “当前 在 线 人 数 1 
A” (监听 器 成 功 ) 。 

UB 更 换 浏览 器 ， 访 问 http://localhost:8080/addSession， 可 以 看 到 浏览 器 提示 “当前 在 线 人 数 2 
As 


UD 多 次 使 用 浏览 器 访问 http://localhost:8080/removeSession， 可 以 看 到 浏览 器 提示 “当前 在 线 人 
数 1 人 ” 
D 使 用 浏览 器 访问 不 存在 的 地 址 ， 会 自动 跳 转 到 http://localhost:8080/online (过 滤器 成 功 ) 。 


从 上 面 的 测试 可 以 看 出 ， 代 码 清单 中 的 类 限制 一 个 浏览 器 只 能 存在 一 个 Session， 在 此 基础 上 
进行 操作 。 过 滤器 、 拦 截 器 、 监 听 器 还 可 以 做 很 多 操作 ， 可 以 结合 实际 应 用 来 使 用 ， 也 可 以 多 个 配 
合 使 用 ， 不 过 需要 注意 设置 对 应 的 优先 级 ， 以 免 踩 到 不 必要 的 “ 坑 ”。 


11.5 事务 使 用 


11.5.1 事务 介绍 


事务 (Transaction〉 是 应 用 程序 中 一 系列 严密 的 操作 ， 所 有 操作 必须 成 功 完成 ， 否 则 在 每 个 操 
作 中 做 的 所 有 更 改 都 会 被 撤销 。 也 就 是 事务 具有 原子 性 ， 一 个 事务 中 的 一 系列 操作 要 么 全 部 成 功 ， 
要 么 一 个 都 不 做 。 事 务 的 结束 有 两 种 ， 当 事务 中 的 所 有 步骤 全 部 成 功 执行 时 ， 事 务 提交 。 如 果 其 中 
一 个 步骤 失败 ， 就 会 发 生 回 滚 操作 ， 撤 销 之 前 做 的 所 有 操作 ， 到 事务 开始 。 
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事务 应 该 具有 4 个 属性 : 原子 性 、 一 致 性 、 隔 离 性 、 持 久 性 。 这 4 个 属性 通常 称 为 ACID 特性 。 


a) 原子 性 CAtomicity) 。 一 个 事务 是 一 个 不 可 分 割 的 工作 单位 ， 事 务 中 包括 的 诸多 操作 要 
么 都 做 ， 要 么 都 不 做 。 

(2) 一 致 性 (Consistency) 。 事 务必 须 使 数据 库 从 一 个 一 致 性 状态 变 成 另 一 个 一 致 性 状态 。 
一 致 性 与 原子 性 是 密切 相关 的 。 

(3) 隔离 性 〈Isolation) 。 一 个 事务 的 执行 不 能 被 其 他 事务 干扰 ， 即 一 个 事务 内 部 的 操作 及 
使 用 的 数据 对 并 发 的 其 他 事务 是 隔离 的 ， 并 发 执行 的 各 个 事务 之 间 不 能 互相 干扰 。 

(4) 持久 性 (Durability) 。 持 和 久 性 也 称 永久 性 (Permanence) ， 是 指 一 个 事务 一 旦 提交 ， 它 
对 数据 库 中 数据 的 改变 就 应 该 是 永久 性 的 ， 接 下 来 的 其 他 操作 或 故障 不 应 该 对 其 有 任何 影响 。 


11.5.0 ”在 项 目 中 使 用 事务 


下 面 使 用 Spring 声明 式 事务 举 一 个 简单 的 例子 。 首 先 创建 一 个 实体 类 Book， 注 意 bookName 
的 字段 长 度 为 10， 稍 后 会 用 到 。Book 类 内 容 如 代码 清单 11-18 所 示 。 


代码 清单 11-18 Spring Boot- 事 务 项 目 实体 类 代码 


GEntity 
public class Book( 


@Id 

@GeneratedValue (strategy = GenerationType.AUTO) 
Private Long id; 

@Column (nullable = false,unique = true,length = 10) 
private String bookName; 


。// 省 略 set, Get 方法 


接 下 来 以 批量 插入 数据 为 例 ， 如 果 不 加 入 事务 ， 异 常 终止 方法 就 不 会 回 滚 ， 这 样 会 造成 一 些 
脏 数据 的 产生 。 启动 项 目 , 使 用 JPA 生成 表 后 , bookName 字段 的 长 度 是 10, 如 果 插 入 的 bookName 
是 “Spring Boot 2 实战 之 旅 ”， 由 于 长 度 的 原因 ,会 产生 异常 并 且 插 入 失败 ,但 是 由 于 没有 事务 的 
原因 ， 失 败 前 的 数据 还 是 会 继续 插入 如 方法 test) ， 当 方法 上 加 入 事务 注解 后 ， 会 统一 进行 数 
据 回 滚 〈 如 方法 test2) ， 完 整 内 容 如 代码 清单 11-19 所 示 。 


代码 清单 11-19 Spring Boot- 事 务 项 目测 试 类 代码 


GRestController 
public class BookController ( 
GAutowired 
private BookRepository bookRepository; 


GGetMapping("/testi") 
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public String testl()( 
bookRepository.save(new Book("JAVA 从 入 门 到 精通 ") ) ; 
bookRepository.save (new Book("SpringBoot2 实战 之 旅 ") ) ; 
return "success"; 


r 


GGetMapping("/test2") 

GTransactional 

public String test2()( 
bookRepository.save(new Book ("JAVA 从 入 门 到 精通 ") ) ; 
bookRepository.save(new Book ("Spring Boot2 实战 之 旅 ") ) ; 
return "success"; 


) 


启动 项 目 ， 分 别 请 求 两 个 方法 ，testl 方法 由 于 没有 事务 的 原因 ， 第 一 条 数据 会 插入 成 功 ， 第 
二 条 数据 会 插入 失败 ， 这 个 插入 的 第 一 条 数据 就 是 我 们 所 说 的 脏 数据 ;test2 方法 由 于 加 入 事务 的 
原因 ， 两 条 数据 都 不 会 插入 成 功 ， 很 显然 ，test2 方法 的 场景 更 符合 我 们 事务 的 特性 。 

接 下 来 ， 我 们 进一步 看 一 下 Spring 事务 的 特性 。 


11.5.3 Spring 事务 拓展 介绍 


Spring 事务 不 仅 可 以 通过 使 用 事务 注解 @Transactional， 同 时 支持 编程 式 使 用 事务 ， 但 是 这 种 
模式 不 常用 。 本 小 节 将 详细 介绍 Spring 事务 。 


1. 事务 隔离 级 别 


使 用 事务 其 实 只 用 到 了 一 个 注解 @Transactional， 这 就 是 Spring 的 注解 式 事 务 。 事 务 隔离 级 别 
是 指 若干 个 事务 并 发 时 的 隔离 程度 ，Spring 声明 事务 可 以 通过 isolation 属性 来 设置 Spring 的 事务 
隔离 级 别 。 其 中 提供 了 以 下 5 种 事务 隔离 级 别 。 
e @Transactional(isolation = Isolation.DEFAULT): 默认 的 事务 隔离 级 别 ， 即 使 用 数据 库 的 事务 
隔离 级 别 。 
* @Transactional(isolation = Isolation READ_UNCOMMITTED): 读 未 提交 ， 这 是 最 低 的 事务 隔 
离 级 别 ， 允 许 其 他 事务 读 取 未 提交 的 数据 ， 这 种 级 别 的 事务 隔离 会 产生 脏 读 ， 不 可 重复 读 和 
幻 读 。 
* @Transactional(isolation = Isolation READ COMMITTED): 读 已 提交 , 这 种 级 别 的 事务 隔离 能 
读 取 其 他 事务 已 经 修改 的 数据 ， 不 能 读 取 未 提交 的 数据 ， 会 产生 不 可 重复 读 和 幻 读 。 
* @Transactional(isolation = Isolation REPEATABLE READ): 可 重复 读 ， 这 种 级 别 的 事务 隔离 
可 以 防止 不 可 重复 读 和 脏 读 ， 但 是 会 发 生 幻 读 。 
e @Transactional(isolation = Isolation.SERIALIZABLE): 串 行 化 ， 这 是 最 高 级 别 的 事务 隔离 ， 会 
避免 脏 读 ， 不 可 重复 读 和 幻 读 。 在 这 种 隔离 级 别 下 ， 事 务 会 按 顺序 进行 。 


2. 
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事务 传播 行为 


事务 传播 行为 是 指 如 果 多 个 事务 同时 存在 ，Spring 就 会 处 理 这 些 事务 的 行为 。 事 务 传播 行为 
分 为 如 下 几 种 。 


PROPAGATION REQUIRED: 如 果 当 前 存在 事务 ， 就 加 入 该 事务 ; 如 果 当 前 没有 事务 ， 就 创 
建 一 个 新 的 事务 ， 这 是 Spring 默认 的 事务 传播 行为 。 

PROPAGATION REQUIRES NEW: 创建 一 个 新 的 事务 ， 如 果 当 前 存在 事务 ， 就 把 当前 事务 
挂 起 。 新 建 事务 和 被 挂 起 的 事务 没有 任何 关系 ， 是 两 个 独立 的 事务 。 外 层 事务 回 滚 失败 时 
不 能 回 滚 内 层 事务 执行 结果 ， 内 外 层 事务 不 能 相互 干扰 。 

PROPAGATION SUPPORTS: 如 果 当 前 存在 事务 ， 就 加 入 该 事务 ; 如 果 当 前 没有 事务 ， 就 以 
非 事 务 的 方式 继续 运行 。 

PROPAGATION NOT SUPPORTED: 以 非 事务 方式 运行 ， 如 果 当 前 存在 事务 ， 就 把 当前 事 
务 挂 起 。 


* PROPAGATION NEVER: 以 非 事务 方式 运行 ， 如 果 当 前 存在 事务 ， 就 抛 出 异常 。 
* PROPAGATION MANDATORY: 如 果 当 前 存在 事务 ， 就 加 入 该 事务 ; 如 果 当 前 没有 事务 ， 


3. 


就 抛 出 异常 。 
PROPAGATION NESTED: 如 果 当 前 存在 事务 ,就 创建 一 个 事务 作为 当前 事务 的 谋 套 事务 来 
运行 ;如 果 当 前 没有 事务 ， 该 取 值 就 等 价 于 PROPAGATION REQUIRED. 


声明 式 事务 属性 


Spring 事务 不 只 拥有 事务 隔离 级 别 和 事务 传播 行为 ， 另 外 还 包含 很 多 属性 供 开发 者 使 用 ， 分 
别 说 明 如 下 。 


value: 存放 String 类 型 的 值 ， 主 要 用 来 指定 不 同 的 事务 管理 器 ， 满 足 在 同一 个 系统 中 存在 不 
同 的 事务 管理 器 。 比 如 在 Spring 容器 中 声明 了 多 种 事务 管理 器 ， 然 后 开发 者 可 以 根据 设置 指 
定 需要 使 用 的 事务 管理 器 。 通 常 一 个 系统 需要 访问 多 个 数据 库 的 场景 下 ， 就 会 设置 多 个 事务 
管理 器 ， 然 后 进行 不 同 的 选择 。 

transactionManager: 与 value 类 似 ， 也 是 用 来 选择 事务 管理 器 。 

propagation: 事务 传播 行为 ， 默 认 值 是 Propagation.REQUIRED。 

isolation: 事务 的 隔离 级 别 ， 默 认 值 是 Isolation. DEFAULT. 

timeout: 事务 的 超时 时 间 ， 默 认 值 是 -1， 如 果 超过 了 设置 的 时 间 还 没有 执行 完成 ， 就 会 自动 
回 滚 当前 事务 。 

readOnly: 当前 事务 是 不 是 只 读 事 务 ， 默 认 值 是 false。 通 常 可 以 设置 读 取 数 据 的 事务 的 属性 
值 为 true。 


* rollbackFor: 可 以 设置 触发 事务 的 指定 异常 ， 允 许 指定 多 个 类 型 的 异常 。 
* noRollbackFor: 与 rollbackFor 相反 ， 可 以 设置 不 触发 事务 的 指定 异常 ， 允 许 指定 多 个 类 型 的 


异常 。 
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4. 事务 回 滚 规则 


Spring 的 事务 回 滚 通常 是 根据 当前 事务 抛 出 异常 的 时 候 , Spring 事务 管理 器 捕捉 到 未 经 处 理 的 
异常 ,然后 根据 规则 来 决定 当前 事务 是 否 回 滨 。 如 果 捕获 的 异常 正好 是 设置 notRollbackFor 属性 的 
异常 ， 那 么 将 不 会 被 捕获 。 在 默认 配置 下 ，Spring 只 有 捕获 运行 时 异常 (RuntimeException) 的 子 
类 时 才 会 进行 回 滚 。 

5. @Transactional 使 用 注意 事项 

在 使 用 @Transactional 注解 的 时 候 ， 需 要 注意 一 些 情况 : 

© @Transactional 需要 在 类 的 上 方 使 用 ， 而 不 是 在 接口 的 上 方 使 用 ， 如 果 在 接口 上 使 用 ， 事 务 

就 会 失效 。 

* @Transactional 只 能 在 public 修饰 的 方法 上 ， 如 果 使 用 在 private 或 protected 修饰 的 方法 上 ， 

事务 就 会 无 效 。 

© (GMlTransactiona 尽量 不 在 类 的 上 方 使 用 ， 因 为 这 样 会 对 类 内 的 全 部 方法 使 用 事务 ， 如 果 对 查 

询 方法 使 用 事务 ， 就 可 能 会 影响 效率 。 


11.6 ”统一 处 理 异 常 


11.6.1 异常 介绍 


异常 是 程序 员 的 梦 寿 ， 甚 至 对 于 程序 员 来 说 ， 这 是 无 法 避免 的 事情 。 当 程序 在 运行 的 时 候 发 
生 了 一 些 不 被 期 望 的 事件 ， 阻 止 程序 按照 程序 员 的 预期 正常 执行 ， 这 就 是 异常 。 在 Java 语言 中 提 
供 了 异常 处 理 机 制 来 解决 异常 的 出 现 。 
当然 ， 一 些 异 常 是 可 以 避免 的 ， 也 有 一 些 是 由 于 外 界 因素 造成 的 无 法 避免 的 异常 ， 比 如 : 
网 络 波动 造成 网 络 通信 连接 异常 。 
打开 不 存在 的 文件 。 
输入 非法 字符 。 
类 型 转换 异常 。 
对 象 的 空 引用 。 
JVM 内 存 溢出 。 


同时 ， 我 们 也 可 以 为 系统 设置 业务 类 异常 ， 当 某 种 场景 有 悖 我 们 的 初衷 时 ， 可 以 定义 对 应 的 
异常 类 抛 出 响应 的 异常 供 我 们 排查 。 


11.6.2 Java 异常 分 类 


在 Java 标准 异常 类 库 中 创建 了 一 些 通用 的 异常 ， 这 些 都 是 以 Throwable 为 顶层 父 类 的 ， 如 图 
11-8 所 示 。 
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11-8 标准 异常 类 结构 


Throwable 又 派生 出 Error 类 和 Exception 类 。Java 的 设计 很 巧妙 ， 其 中 : 

© Error 类 一 般 代表 错误 ， 通 常 代表 JVM 本 身 的 错误 ， 并 且 这 些 错误 是 无 法 被 修复 和 捕获 的 。 

* Exception 类 代表 Java 标准 异常 库 经 常 发 生 的 异常 。 通 常 代 表 程序 运行 时 发 生 的 不 在 预期 中 
的 情况 ， 这 种 异常 可 以 被 Java 异常 机 制 处 理 。 在 Exception 异常 中 ,通常 有 两 个 重要 的 子 类 ， 
P? IOException 类 和 RuntimeException 类 。 

对 于 我 们 常 处 理 的 异常 ， 通 常 分 为 两 类 ， 分 别 说 明 如 下 。 

(1) 非 检查 异常 (unckecked exception ) 
Error 和 RuntimeException 以 及 它们 的 子 类 。 在 Java 编译 的 时 候 ， 无 法 发 现 这样 的 异常 ， 只 有 


在 运行 时 才能 出 现 该 异常 。 常 见 的 一 些 非 检查 异常 如 下 。 


© ArithmeticException: 当 出 现 异常 的 运算 条 件 时 ， 抛 出 此 异常 。 例 如 ， 一 个 整数 “ 除 以 零 ” 时， 
抛 出 此 类 的 一 个 实例 。 

*  AmayIndexOutOfBoundsException: 用 非法 索引 访问 数组 时 抛 出 的 异常 。 如 果 索 引 为 负 或 大 于 
等 于 数组 大 小 ， 该 索引 就 为 非法 索引 。 

* ClassCastException; 当 试 图 强制 将 对 象 转换 为 不 是 实例 的 子 类 时 ， 抛 出 该 异常 。 
IllegalArgumentException: 抛 出 的 异常 表明 向 方法 传递 了 一 个 不 合法 或 不 正确 的 参数 。 
IndexOutOfBoundsException: 指示 某 排 序 索 引 ( 例如 对 数组 、 字 符 串 或 向 量 的 排序 ) 超出 范 
围 时 抛 出 。 

* NullPointerException: 当 应 用 程序 试图 在 需要 对 象 的 地 方 使 用 null 时 ， 抛 出 该 异常 。 

* NumberFormatException: 当 应 用 程序 试图 将 字符 串 转换 成 一 种 数值 类 型 ， 但 该 字符 串 不 能 转 
换 为 适当 格式 时 ， 抛 出 该 异常 。 

(2) 检查 异常 (checked exception ) 
在 Java 编译 的 过 程 中 ， 这 些 错误 必须 进行 修复 ， 如 果 不 对 异常 进行 处 理 ， 就 无 法 编译 通过 。 


常见 的 一 些 检查 异常 如 下 。 
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* ClassNotFoundException: 应 用 程序 试图 加 载 类 时 ， 找 不 到 相应 的 类 ， 抛 出 该 异常 。 
* JllegalAccessException: 拒绝 访问 一 个 类 的 时 候 ， 抛 出 该 异常 。 
* NoSuchMethodException: 请 求 的 方法 不 存在 。 


11.6.3 Spring Boot 中 统一 处 理 异常 


在 Spring Boot 项 目 中 存在 一 套 异 常 页 面 ， 在 访问 错误 的 时 候 会 提示 Whitelabel Error Page。 这 
对 于 很 多 互联 网 项 目 (网 站 项 目 ) 看 起 来 不 是 很 友好 , 一 般 情况 下 会 返回 一 个 统一 页 面 来 友好 地 提 
示 用 户 。 其 实在 Spring Boot 中 只 需要 创建 一 个 实现 ErrorController 的 类 来 统一 处 理发 生 错误 的 请 
求 即 可 ， 如 代码 清单 11-20 所 示 。 


代码 清单 11-20 Spring Boot- 异 常 项 目 自 定义 异常 代码 


GRestController 
public class CommonErrorController implements ErrorController ( 
private final String ERROR PATH - "/error"; 


GOverride 

public String getErrorPath() ( 
return ERROR PATH; 

} 


GRequestMapping(value = ERROR PATH) 

public String handleError()( 
System.out.println(getErrorPath()); 
return "error"; 


) 


上 述 代码 可 以 清晰 地 看 出 实现 的 功能 ， 实 质 上 就 是 将 error 请 求 拦截 到 一 个 通用 方法 ， 这 里 返 
回 了 一 串 字 符 串 , 其 实 也 可 以 返回 一 个 友好 页 面 展 示 给 用 户 。 具体 测试 就 不 展示 了 , 内 容 比较 简单 。 
感 兴趣 的 读者 可 以 设置 一 些 自 定义 异常 进行 异常 捕获 等 ， 快 去 尝试 一 下 吧 。 


11.7 使 用 AOP 


前 面 介绍 了 如 何 使 用 拦截 器 打印 日 志 等 , 其 实 Spring 的 AOP 特性 可 以 做 到 不 修改 业务 的 基础 
上 ， 利 用 AOP 对 业务 逻辑 的 各 个 部 分 进行 隔离 ， 从 而 使 得 业务 逻辑 各 部 分 之 间 的 耦合 度 降 低 ， 提 
高 程序 的 可 重用 性 ， 同 时 提高 开发 的 效率 。 本 节 将 介绍 Spring Boot 如 何 使 用 AOP. 
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11.7.1 AOP 介绍 


AOP CAspect-Oriented Programming， 面 向 切面 编程 ) 是 Spring 框架 面向 切面 的 编程 思想 ， 其 
利用 一 种 被 我 们 称 为 “ 横 切 ”的 技术 ， 对 OOP CObject-Oriented Programing， 面 向 对 象 编程 ) 进行 了 
补充 和 完善 。 使 用 AOP 的 横向 切入 可 以 对 系统 进行 无 侵入 性 的 日 志 监听 、 事 务 管理 、 权 限 管理 等 。 

我 们 来 看 一 下 AOP 的 组 成 成 员 。 


* Aspect 切面 ， 可 以 理解 为 横 切 多 个 class 的 一 个 关注 点 的 模块 化 。 事 务 管理 是 一 个 很 好 的 例 
子 。 在 Spring AOP P, Aspect 可 以 用 普通 类 或 者 带 有 (@Aspect 注解 的 普通 类 来 实现 。 

Join point: 连接 点 ， 程 序 执 行 期 间 的 连接 点 ， 一 般 是 指 方法 的 调用 。 

Advice: 通知 ， 在 特定 切入 点 上 执行 的 操作 。 

Pointcut: 切入 点 ， 带 有 通知 的 连接 点 。 

Target object: 目标 对 象 ， 由 一 个 或 者 多 个 切面 通知 的 对 象 。 

AOP proxy: AOP 代理 ， 由 AOP 框架 创建 的 对 象 。 


Advice 分 为 以 下 几 种 。 


* Before advice: 前 置 通知 ， 在 一 个 连接 点 之 前 执行 的 通知 ， 正 常情 况 下 没有 办 法 阻止 后 面 的 
执行 ， 除 非 产生 异常 。 

* After returning advice: 返回 通知 ， 在 一 个 连接 点 正常 执行 完 所 有 操作 后 执行 的 通知 。 

* Afterthrowing advice: 异常 通知 ， 在 一 个 方法 抛 出 异常 后 执行 的 通知 。 

© After(finally) advice: 后 置 通知 ， 在 方法 结束 后 执行 ,无 论 是 正常 执行 还 是 异常 退出 都 会 执行 
的 通知 。 

* Around advice; 环绕 通知 ， 环 绕 一 个 连接 点 ， 比 如 方法 调用 的 通知 。 这 是 最 强 的 一 种 通知 。 
环绕 通知 可 以 在 方法 调用 之 前 或 之 后 执行 自 定义 的 行为 。 它 也 负责 选择 是 否 处 理 连接 点 方法 
的 执行 ， 通 过 返回 一 个 特有 的 值 或 者 抛 出 异常 。 环 绕 通 知 是 使 用 最 普遍 的 一 种 通知 。 


11.7.2. Spring Boot 使 用 AOP 

接 下 来 ， 我 们 以 打印 日 志 为 例 介 绍 在 Spring Boot 中 使 用 切面 的 两 种 方法 ， 即 直接 使 用 切面 和 
自 定义 注解 式 切 面 。 

1. 直接 使 用 切面 

新 建 项 目 ， 在 项 目 中 加 入 AOP 依赖 ，pom 文件 依赖 内 容 如 代码 清单 11-21 所 示 。 


代码 清单 11-21 Spring Boot-AOP 项 目 配置 文件 代码 


<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 
</dependency> 
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<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-aop</artifactId> 
</dependency> 


创建 一 个 日 志 切 面 类 LogAspect, 在 类 上 加 入 注解 @Aspect, 表明 这 是 一 个 切面 类 , (à Component 
表示 把 当前 类 实例 化 到 Spring 容器 中 ， 如 果 含 有 多 个 注解 ， 那 么 可 以 使 用 @Order(number) 注 解 指 
定 切 面 类 的 优先 级 (注意 : 这 里 的 number 代表 数字 , 数字 的 值 越 小 , 优先 级 越 高 ), 使 用 这 个 LogAspect 
切面 让 com.dalaoyang.controller 包 下 所 有 类 打印 日 志 。 完 整 LogAspect 类 内 容 如 代码 清单 11-22 所 示 。 


代码 清单 11-22 Spring Boot-AOP 项 目 切 面 代码 


QGAspect 

GComponent 

public class LogAspect ( 
GPointcut("execution(public * com.springboot.controller.*.*(..))") 
public void LogAspect () {} 


GBefore ("LogAspect () ") 

public void doBefore(JoinPoint joinPoint)( 
System.out.println("doBefore"); 

) 


GAfter("LogAspect () ") 

public void doAfter(JoinPoint joinPoint)( 
System.out.println("doAfter"); 

b 


GAfterReturning ("LogAspect ()") 

public void doAfterReturning(JoinPoint joinPoint)( 
System.out.println("doAfterReturning"); 

b 


GAfterThrowing ("LogAspect () ") 
public void deAfterThrowing(JoinPoint joinPoint)( 
System.out.println("deAfterThrowing"); 


GAround ("LogAspect () ") 

public Object deAround(ProceedingJoinPoint joinPoint) throws Throwable(í 
System.out.println("deAround"); 
return joinPoint.proceed(); 
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从 上 述 代码 清单 中 可 以 看 到 使 用 了 很 多 注解 ， 分 别 说 明 如 下 。 


* @Pointcut: 切入 点 ， 其 中 execution 用 于 使 用 切面 的 连接 点 。 使 用 方法 : execution (方法 修饰 
符 (可 选 ) 返回 类 型 方法 名 参数 异常 模式 (可 选 ))， 可 以 使 用 通配符 匹配 字符 ，* 可 以 匹 
配 任意 字符 。 
(Before: 在 方法 前 执行 。 
@After: 在 方法 后 执行 。 
@AfterReturning: 在 方法 执行 后 返回 一 个 结果 后 执行 。 
@AfterThrowing: 在 方法 执行 过 程 中 抛 出 异常 的 时 候 执 行 。 
@Around: 环绕 通知 ， 在 执行 前 后 都 可 以 使 用 。 这 个 方法 参数 必须 为 ProceedingJoinPoint, 
proceed() 方 法 就 是 被 切面 的 方法 ，@Before、@After、@AfterRetuming 和 @AfterThrowing 四 
个 方法 可 以 使 用 JoinPoint, JoinPoint 包含 类 名 、 被 切面 的 方法 名 、 参 数 等 信息 。 

直接 使 用 切面 的 方式 大 致 就 是 上 述 这 样 的 ， 还 可 以 在 其 中 加 入 业务 逻辑 ， 有 具体 可 以 根据 业务 
需求 来 使 用 ， 接 下 来 笔者 带领 大 家 学 习 如 何 使 用 注解 式 切面 。 

2. 自 定义 注解 式 切 面 

注解 是 一 种 能 够 被 添加 到 Java 代码 中 的 元 数据 ， 类 、 方 法 、 变 量 、 参 数 和 包 都 可 以 用 注解 来 
修饰 。 注 解 对 于 它 所 修饰 的 代码 并 没有 直接 的 影响 。 创 建 自 定 义 注 解 其实 和 创建 接口 是 一 致 的 。 接 
下 来 我 们 创建 一 个 在 方法 使 用 前 后 打印 时 间 的 自 定义 注解 。 

新 建 一 个 自 定义 注解 类 DoneTime， 如 代码 清单 11-23 所 示 。 


代码 清单 11-23 Spring Boot-AOP 项 目 自 定义 注解 代码 


GTarget((ElementType.METHOD, ElementType.TYPE)) 
GRetention (RetentionPolicy.RUNTIME) 
public Ginterface DoneTime ( 
String param() default ""; 
H 


这 样 还 不 算 完 ， 还 需要 为 自 定义 注解 创建 一 个 切面 ， 与 11.7.1 小 节 的 切面 类 一 致 ， 这 里 使 用 
@Around 注解 ， 如 代码 清单 11-24 所 示 。 


代码 清单 11-24 Spring Boot-AOP 项 目 自 定义 注解 实现 类 代码 


GAspect 
GComponent 
public class DoneTimeAspect ( 
GAround ("Gannotation (doneTime)") 
public Object around(ProceedingJoinPoint joinPoint, DoneTime doneTime) 
throws Throwable ( 
System.out .println(" 方 法 开始 时 间 是 :"+new Date()); 
Object o = joinPoint.proceed(); 
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System.out .Println(" 方 法 结束 时 间 是 :"+new Date()) ; 


return o; 


) 


到 这 里 ， 两 种 方式 的 切面 已 经 创建 完成 了 。 接 下 来 , TE com.springboot.controller 包 下 创建 一 个 
TestController 进行 测试 ， 其 中 testl 方法 加 入 我 们 刚刚 自 定义 的 注解 @DoneTime(param = 
"TestController)， 加 入 后 访问 方法 ， 控 制 台 会 打印 两 个 切面 输出 的 内 容 ; 而 test2 方法 由 于 没有 加 
入 自 定 义 注 解 ， 因 此 只 会 打印 LogAspect 切面 日 志 。 


11.8 使 用 validator 后 台 校 验 


通常 来 说 ， 在 前 端 提交 数据 到 后 端的 时 候 ， 会 进行 一 定 的 校 验 ， 比 如 使 用 jquery.validate.js 或 
者 当前 留 下 的 Vue 框架 中 的 vue-validator 进行 校 验 。 但 是 这 样 还 会 有 一 定 的 风险 , 所 以 我 们 会 在 后 
台 对 数据 格式 进行 校 验 。 在 Java 或 Hibernate 中 都 提供 了 一 些 校 验 的 注解 ， 本 节 学 习 使 用 后 台 校 验 
数据 格式 。 

首先 来 看 供 我 们 使 用 的 后 台 校 验 的 注解 ， 分 别 说 明 如 下 。 
Walid: 被 注释 的 元 素 是 一 个 对 象 ， 需 要 检查 此 对 象 的 所 有 字段 值 。 
(Null: 被 注释 的 元 素 必须 为 null. 
(QNotNull: 被 注释 的 元 素 必须 不 为 null。 
(@AssertTrue: 被 注释 的 元 素 必 须 为 true。 
人 @AssertFalse: 被 注释 的 元 素 必须 为 false. 
@Min(value): 被 注释 的 元 素 必须 是 一 个 数字 ， 其 值 必须 大 于 等 于 指定 的 最 小 值 。 
@Max(value): 被 注释 的 元 素 必须 是 一 个 数字 ， 其 值 必 须 小 于 等 于 指定 的 最 大 值 。 
@DecimalMin(value): 被 注释 的 元 素 必须 是 一 个 数字 ， 其 值 必须 大 于 等 于 指定 的 最 小 值 。 
@DecimalMax(value): 被 注释 的 元 素 必须 是 一 个 数字 ， 其 值 必须 小 于 等 于 指定 的 最 大 值 。 
@Size(max, min): 被 注释 的 元 素 的 大 小 必须 在 指定 的 范围 内 。 
@Digits (integer, fraction): 被 注释 的 元 素 必须 是 一 个 数字 ， 其 值 必须 在 可 接受 的 范围 内 。 
@Past: 被 注释 的 元 素 必须 是 一 个 过 去 的 日 期 。 
@Future: 被 注释 的 元 素 必 须 是 一 个 将 来 的 日 期 。 
@pPattern(value): 被 注释 的 元 素 必 须 符 合 指定 的 正则 表达 式 。 
@Email: 被 注释 的 元 素 必须 是 电子 邮箱 地 址 。 
@Length(min=, max=): 被 注释 的 字符 囊 的 大 小 必须 在 指定 的 范围 内 。 
@NotEmpty: 被 注释 的 字符 串 必 须 非 空 。 
@Range(min=, max=): 被 注释 的 元 素 必须 在 合适 的 范围 内 。 
@NotBlank: 被 注释 的 字符 串 必须 非 空 。 
(QURL(protocol-, host-, port=, regexp=, flags=): 被 注释 的 字符 串 必须 是 一 个 有 效 的 URL. 
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© @CreditCardNumber: 被 注释 的 字符 串 必 须 通过 Luhn 校 验 算法 ， 银 行 卡 、 信 用 卡 等 号 码 一 般 
都 用 Luhn 计算 合法 性 。 

* @ScriptAssert (lang=, script-, alias=): 要 有 Java Scripting API, FP JSR 223 ("Scripting for the 
JavaTM Platform") 的 实现 。 

e @SafeHtml(whitelistType=,additionalTags=): classpath 中 要 有 jsoup 包 。 


@NotNull, @NotEmpty, @NotBlank 三 个 注解 的 区 别 如 下 。 


* @NotNull: 任何 对 象 的 value 不 能 为 null。 
* @NotEmpty: 集合 对 象 的 元 素 不 为 0， 即 集合 不 为 空 ， 也 可 以 用 于 字符 串 不 为 null。 
© (üNotBlank: 只 能 用 于 字符 串 不 为 null， 并且 字符 囊 trim() 以 后 length 要 大 于 0. 


接 下 来 ， 笔 者 带领 大 家 使 用 这 些 注 解 。 新建 项 目 , 在 pom 文件 中 加 入 hibernate-validator 依赖 ， 
如 代码 清单 11-25 所 示 。 


代码 清单 11-25 Spring Boot- 后 台 校 验 项 目 依赖 代码 


<dependency> 
XgroupId»org.springframework.boot«/groupId» 
X«artifactId»spring-boot-starter-web«/artifactId» 

</dependency> 

<dependency> 
<groupId>org.hibernate</groupId> 
<artifactId>hibernate-validator</artifactId> 
<version>6.0.4.Final</version> 

</dependency> 


创建 一 个 User 实体 类 ， 在 实体 中 的 几 个 属性 上 加 入 注解 进行 校 验 ， 分 别 说 明 如 下 。 
userName: 字段 不 能 为 空 ， 并 且 长 度 在 6~ 12 之 间 。 

passWord: 密码 不 能 为 空 ， 并 且 长 度 不 能 小 于 6. 

email: 需要 符合 邮箱 格式 。 

idCard: 需要 符合 身份 证 格式 。 

phone: 需要 符合 手机 号 格式 。 


完整 User 实体 类 内 容 如 代码 清单 11-26 所 示 。 


代码 清单 11-26 — Spring Boot- 后 台 校 验 项 目 实体 类 代码 


public class User implements Serializable ( 
private static final long serialVersionUID - -7362371894429216969L; 


GNotEmpty (message=" 用 户 名 不 能 为 空 ") 
GLength (min=6,max = 12,message=" 用 户 名 长 度 必须 位 于 6 到 12 之 间 ") 
Private String userName; 


290 | Spring Boot 2 实战 之 旅 


GNotEmpty (message=" 密 码 不 能 为 空 ") 
GLength (min=6,message=" 密 码 长 度 不 能 小 于 6 位 ") 


Private String passWord; 


Q@Email (message=" 邮 箱 格式 错误 ") 


private String email; 


GPattern(regexp = "^(\\d{18, 18} |\\d{15,15} | (\\d{17,17} IxIX])) $", 
message = "身份 证 格式 错误 ") 

private String idCard; 

GPattern(regexp = "^((13[0-9](1])1159|153)4NMd(8) $", message = "手机 号 格 
式 错误 ") 


private String phone; 


// 省 略 set. Get 方法 


) 


最 后 ， 创 建 一 个 TestController 进行 测试 。 使 用 BindingResult 类 的 getAllErrors0 方 法 可 以 获取 
不 符合 校 验 的 提示 集合 , 具体 怎么 展示 可 以 根据 项 目 情况 决定 , 这 里 是 将 错误 信息 拼接 成 字符 串 返 
回 前 台 ， 如 代码 清单 11-27 所 示 。 


代码 清单 11-27 Spring Boot- 后 台 校 验 项 目测 试 类 代码 


@RestController 
public class TestController ( 


GPostMapping ("/") 
public String testDemo(G8Valid User user, BindingResult bindingResult)( 


System.out.println(user.toString()); 
StringBuffer stringBuffer - new StringBuffer(); 


if(bindingResult.hasErrors())( 
List«ObjectError» list -bindingResult.getAllErrors(); 
for (ObjectError objectError:list) ( 
stringBuffer.append(objectError.getDefaultMessage()); 
stringBuffer.append("---"); 


H 
return stringBuffer!-null?stringBuffer.toString():""; 


) 


使 用 POST 请 求 访问 testDemo0 方 法 ， 如 果 输 入 不 符合 校 验 条 件 ， 就 会 对 应 输出 提示 到 前 人 台 。 
由 于 篇 幅 原因 ， 这 里 不 做 测试 了 ， 感 兴趣 的 读者 可 以 自行 测试 。 
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11.9 使 用 Swagger 构建 接口 文档 


在 应 用 开发 过 程 中 经 常 需要 对 其 他 应 用 或 者 客户 端 提供 RESTful API 接口 ， 尤 其 是 在 版 本 快 
GANE CRISE T RP, 修改 接口 的 同时 还 需要 同步 修改 对 应 的 接口 文档 , 这 使 我 们 总 是 做 着 
重复 的 工作 ， 并 且 如 果 忘 记 修 改 接口 文档 ， 就 可 能 造成 不 必要 的 麻烦 。 本 节 学 习 Spring Boot 框架 
使 用 Swagger 构建 RESTful API。 


11.9.1 什么 是 Swagger 


Swagger (官网 地 址 : https://swagger.io/) 是 一 个 规范 和 完整 的 框架 ， 用 于 生成 、 描 述 、 调 用 
和 可 视 化 RESTful 风格 的 Web 服务 。 总 体 目标 是 使 客户 端 和 文件 系统 作为 服务 器 ， 以 同样 的 速度 
来 更 新 。 文 件 的 方法 、 参 数 和 模型 紧密 集成 到 服务 器 端的 代码 中 , 允许 API 始终 保持 同步 。Swagger 
让 部 署 管 理 和 使 用 功能 强大 的 API 从 未 如 此 简单 。 

在 Spring Boot 项 目 中 使 用 Swagger 其 实 很 简单 ， 大 致 分 为 以 下 三 步 : 


CD 加 入 Swagger 依赖 。 
(2) 加 入 Swagger 文档 配置 。 
(3) 使 用 Swagger 注解 编写 API 文档 和 API 实体 模板 。 


11.9.2. Swagger 2 注解 介绍 


由 于 Swagger 2 提供 了 非常 多 的 注解 供 开发 使 用 ， 这 里 仅 列举 一 些 笔者 认为 常用 的 注解 。 

4. Api 

@Api 用 在 接口 文档 资源 类 上 ,用 于 标记 当前 类 为 Swagger 的 文档 资源 。 其 中 含有 几 个 常用 属 
性 ， 分 别 说 明 如 下 。 
Value: 定义 当前 接口 文档 的 名 称 。 
description: 用 于 定义 当前 接口 文档 的 介绍 。 
tag: 可 以 使 用 多 个 名 称 来 定义 文档 ， 但 若 同时 存在 tag 属性 和 value 属性 ， 则 value 属性 会 失效 。 
hidden: 如 果 值 为 rue， 就 会 隐藏 文档 。 


2.ApiOperation 
@ApiOperation 用 在 接口 文档 的 方法 上 ， 主 要 用 来 注解 接口 。 其 中 包含 几 个 常用 属性 ， 分 别 说 
明 如 下 。 


* value: 对 API 的 简短 描述 。 
* note: API 的 有 关 细 节 描 述 。 
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* esponse: 接口 的 返回 类 型 ( 注意 : 这 里 不 是 返回 实际 响应 ， 而 是 返回 对 象 的 实际 结果 )。 

* hidden: 如 果 值 为 tue， 就 会 在 文档 中 隐藏 。 

3. ApiResponse. ApiResponses 

(QApiResponses 和 人 @ApiResponse 二 者 配合 使 用 返回 HTTP 状态 码 。@ApiResponses 的 value 
值 是 @ApiResponse 的 集合 ， 多 个 @ApiResponse 用 逗号 分 隔 。 其 中 ，@ApiResponse 包含 的 属性 
如 下 。 

* code: HTTP 状态 码 。 

* message: HTTP 状态 信息 。 

* responseHeaders: HTTP 响应 头 。 


4.ApiParam 

@ApiParam 用 于 方法 的 参数 ， 其 中 包含 以 下 几 个 常用 属性 。 
* name: 参数 的 名 称 。 

* value: 参数 值 。 

* required: 如 果 值 为 true， 就 是 必 传 字段 。 

* defaultValue: 参数 的 默认 值 。 

€ typ: 参数 的 类 型 。 

e hidden: 如 果 值 为 tue， 就 隐藏 这 个 参数 。 


5. ApilmplicitParam, ApilmplicitParams 


二 者 配合 使 用 在 API 方法 上 ，@ApiImplicitParams 的 子 集 是 @ApiImplicitParam 注解 ， 其 中 
@ApiImplicitParam 注解 包含 以 下 几 个 参数 。 
name: 参数 的 名 称 。 
value: 参数 值 。 
required: 如 果 值 为 tue， 就 是 必 传 字段 。 
defaultValue: 参数 的 默认 值 。 
dataType: 数据 的 类 型 。 
hidden: 如 果 值 为 ttue， 就 隐藏 这 个 参数 。 
allowMultiple: 是 否 允 许 重复 。 


o 


. ResponseHeader 
API 文档 的 响应 头 ， 如 果 需 要 设置 响应 头 ， 就 将 @ResponseHeader 设置 到 @ApiResponse 的 
responseHeaders 参数 中 。@ResponseHeader 提供 了 以 下 几 个 参数 。 


* name: 响应 头 名 称 。 
* description: 响应 头 备注 。 
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7.ApiModel 


设置 API 响应 的 实体 类 ， 用 作 API 返回 对 象 。@ApiModel 提供 了 以 下 几 个 参数 。 
* value; 实体 类 名 称 。 

* description: 实体 类 描述 。 

* SubTypes: 子 类 的 类 型 。 


8. ApiModelProperty 


设置 API 响应 实体 的 属性 ， 其 中 包含 以 下 几 个 参数 。 


name: 属性 名 称 。 

value: 属性 值 。 

notes: 属性 的 注释 。 

dataType: 数据 的 类 型 。 

required: 如 果 值 为 tue， 就 必须 传 入 这 个 字段 。 
hidden: 如 果 值 为 tue， 就 隐藏 这 个 字段 。 
readOnly: 如 果 值 为 tue， 字 段 就 是 只 读 的 。 
allowEmptyValue: 如 果 为 true， 就 允许 为 空 值 。 


Swagger 还 提供 了 很 多 注解 ， 这 里 就 不 一 一 介绍 了 。 如 果 感 兴趣 ， 可 以 到 Swagger 的 Github 
上 查找 相关 文档 ， 地 址 是 https://github.com/swagger-api/swagger-core。 


11.9.3 Spring Boot 使 用 Swagger 


前 面 介绍 了 一 些 Swagger 常用 的 注解 。 接 下 来 ， 笔 者 带领 大 家 学 习 Spring Boot 项 目 使 用 
Swagger 构建 RESTful API。 首 先 创建 一 个 项 目 ， 在 项 目 中 加 入 Swagger 依赖 ， 如 代码 清单 11-28 
所 示 。 


代码 清单 11-28 Spring Boot-Swagger 项 目 依赖 代码 


<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 

</dependency> 

<dependency> 
<groupId>io.springfox</groupId> 
<artifactId>springfox-swagger2</artifactId> 
<version>2.9.2</version> 

</dependency> 

<dependency> 
<groupId>io.springfox</groupId> 
<artifactId>springfox-swagger-ui</artifactId> 
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<version>2.9.2</version> 
</dependency> 


接 下 来 创建 一 个 Swagger 配置 类 Swagger2Config, 在 配置 类 上 加 入 注解 @EnableSwagger2, 表 
明 开 启 Swagger， 注 入 一 个 Docket 类 来 配置 一 些 API 相关 信息 ， 如 apiInfo() 方法 内 定义 了 这 样 几 
个 文档 信息 ， 分 别 说 明 如 下 。 
tile: 值 为 接口 文档 标题 。 
description; 值 为 接口 文档 的 详细 描述 。 
termsOfServiceUrl: 一 般 用 于 存放 公司 的 地 址 ， 这 里 使 用 的 是 Swagger 官网 。 
version: API 文 档 的 版 本 号 。 


createRestApi() 方 法 内 定义 了 Swagger 文档 扫描 的 包 ， 如 代码 清单 11-29 所 示 。 


代码 清单 11-29 Spring Boot-Swagger 项 目 配置 代码 


GConfiguration 
GEnableSwagger2 
public class Swagger2Config ( 
GBean 
public Docket createRestApi() ( 
return new Docket (DocumentationType.SWAGGER 2) 
.apiInfo (apiInfo()) 
.select() 
// swagger 文档 扫描 的 包 
.apis (RequestHandlerSelectors.basePackage ("com.springboot.co 
ntroller")) 
.paths (PathSelectors.any()) 
.build(); 


private ApiInfo apiInfo() ( 
return new ApiInfoBuilder() 
.title ("接口 列表 v1.0.0") 
.description ("Swagger2 接口 文档 地 址 ") 
.termsOfServiceUr1 ("https://swagger.io/") 
.version("v1.0.0") 
:build(); 


) 


创建 一 个 User 实体 ， 使 用 前 面 介绍 的 @ApiModel 注解 表明 这 是 一 个 Swagger 返回 的 实体 ， 
@ApiModelProperty 注解 表明 几 个 实体 的 属性 ， 如 代码 清单 11-30 所 示 。 
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代码 清单 11-30 Spring Boot-Swagger 项 目 实体 类 代码 


GApiModel(value = "用 户 ",description = "用 户 实体 类 ") 
public class User ( 


GApiModelProperty(value = "用 户 id",hidden = true) 


LI 


private Long id; 


GApiModelProperty(value = "JHP fk") 
private String userName; 
GApiModelProperty(value = "用 户 密码 ") 


private String userPassword; 


// 这 里 省 略 set、Get 方法 
) 


最 后 ， 创 建 一 个 UserController 作为 API 文档 ， 这 个 测试 API 没有 使 用 数据 库 ， 只 是 做 了 一 些 
简单 的 操作 方法 供 读者 查看 。 结 合 前 面 的 介绍 ， 相 信 大 家 已 经 对 Swagger 使 用 有 了 很 深刻 的 认识 。 
接 下 来 ， 我 们 来 看 一 下 UserController 类 的 完整 内 容 ， 如 代码 清单 11-31 所 示 。 


代码 清单 11-31 Spring Boot-Swagger 项 目 API 文档 类 代码 


@RestController 
GRequestMapping (value-"/users") 
GApi (value=" 用 户 操 作 接 口 ",tags={" 用 户 操作 接口 "}) 


Public class UserController { 


GApiOperation (value=" 获 取 用 户 详细 信息 "，notes=" 根 据 用 户 的 id 来 获取 用 户 详细 信息 ") 
GApilmplicitParam(name = "id", value = "HJ" ID", required = true,paramType 
= "query", dataType = "long") 
GGetMapping (value-"/findById") 
public User findById(G86RequestParam(value = "id")long id)( 
return new User (id,"dalaoyang","123"); 
i; 


GApiOperation (value=" 保 存 用 户 "，notes=" 保 存 用 户 ") 

GPostMapping (value-"/saveUser") 

public String saveUser(GRequestBody @ApiParam(name=" 用 户 对 象 ", value=" 传 
入 json 格式 ", required=true) User user)( 

return user.toString(); 

} 

GApiOperation (value=" 修 改 用 户 "，notes=" 修 改 用 户 ") 

@ApiImplicitParams ({ 

GApilmplicitParam (name-"id",value-"X $6 id",required-true, 

paramType-"query",dataType-"long"), 
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QApiImplicitParam (name="username",value=" 用 户 名 称 "， 
required-true,paramType-"query",dataType = "String"), 
QApiImplicitParam (name="password",value=" 用 户 密码 "， 
required=true,paramType="query", dataType = "String") 
n 
GGetMapping(value-"/updateUser") 
public String updateUser(G8RequestParam(value = "id")long id, 
GRequestParam(value = "username")String username, 
GRequestParam(value = "password")String password) { 
User user = new User(id, username, password); 
return user.toString(); 
l; 


GApiOperation (value=" 删 除 用 户 "，notes=" 根 据 用 户 的 id 来 删除 用 户 ") 


QGApiImplicitParam(name = "id", value = 


"HP ID", required - true,paramType 
- "query", dataType - "Integer") 
GApiResponses(( 


GApiResponse (code = 200,message "成 功 ! ") ， 
GApiResponse (code = 401,message = "未 授权 ! "), 
GApiResponse(code = 404,message = "页 面 未 找到 ! "), 
GApiResponse(code = 403,message = "出 错 了 ! ") 
GDeleteMapping (value-"/deleteUserById") 
public String deleteUserById(GRequestParam(value - "id")int id)( 
return "success!"; 


) 


启动 项 目 , 访问 http://localhost:8080/swagger-ui.html, 可 以 看 到 我 们 定义 的 文档 已 经 在 Swagger 
页 面 上 显示 了 ， 如 图 11-9 所 示 。 


n 


swagger 
接口 列表 v1.0.0 9? 
ER 
ISSUE 
用 户 操作 接口 we conroler > 
Models » 


图 11-9 Swagger 项 目 文档 页 面 首页 
单 击 用 户 操作 接口 ， 可 以 看 到 这 个 API 中 的 几 个 具体 的 接口 ， 如 图 11-10 所 示 。 
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用 户 操作 接口 user controter 


|. PEN 


[users/findById 区 用 户 详细 信息 


/users/updateUser WAP 


图 11-10 Swagger 项 目 API 图 片 


单 击 下 方 的 Models. 可 以 查看 我 们 在 项 目 内 定义 的 接口 返回 对 象 列表 。 
实体 ， 如 图 11-11 所 示 。 


这 里 只 定义 了 一 个 User 


meas 


string. 
meam 


string 
Ld 


图 11-11. Swagger Ji H Models 实体 


回 到 接口 列表 ， 以 删除 用 户 接口 为 例 ， 单 击 删除 用 户 接口 ， 可 以 看 到 接口 定义 的 参数 、 返 回 


值 、 响 应 码 等 ， 单 击 Try it out 按钮 可 以 发 起 调用 请 求 、 删 除 用 户 接口 ， 如 图 11-12 所 示 。 


»n |deleteUserById mwa? 


[n 


pm 

" mmo 
Responses — ya 
cos Descr 


图 11-12. Swagger 项 目 删除 用 户 文档 代码 


至 于 其 他 接口 ， 这 里 就 不 展示 了 ， 感 兴趣 的 读者 可 以 下 载 示例 代码 进行 查看 。 
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11.10 “使 用 ApiDoc 构建 接口 文档 


11.9 节 介绍 了 使 用 Swagger 构建 接口 文档 ， 本 节 介 绍 另 一 个 构建 接口 文档 的 框架 一 一 ApiDoc 


11.10.1 如 何 使 用 ApiDoc 接口 文档 


在 Spring Boot 应 用 程序 中 使 用 ApiDoc 文档 很 简单 ， 大 致 分 为 如 下 三 步 : 


(1) 加 入 ApiDoc 依赖 。 
(2) 在 启动 类 上 加 入 @EnableApi2Doc 注解 启用 ApiDoc。 
(3) 构建 ApiDoc 文档 和 实体 。 


11.10.2 ApiDoc 常用 注解 


ApiDoc 中 没有 提供 像 Swagger 那么 多 的 注解 , ApiDoc 的 注解 都 是 可 以 在 类 上 、 实 体 上 共同 使 
用 的 。ApiDoc 提供 的 常用 注解 如 下 。 

1. Api2Doc 

@Api2Doc 注解 主要 用 于 对 文档 的 生成 。 如 果 @Api2Doc 修饰 在 类 上 ， 就 相当 于 将 当前 类 作为 
ApiDoc 文档 。 当 服务 启动 时 ，Api2Doc 会 扫描 Spring 容器 中 所 有 的 Controller 类 ， 当 Controller 类 
上 含有 @Api2Doc 注解 时 ， 才 会 被 Api2Doc 生成 接口 文档 。 当 生成 接口 文档 后 ， 会 在 ApiDoc 页 面 
左 侧 生 成 一 个 菜单 ， 其 中 注解 内 的 name 值 就 是 菜单 名 。 同时， @Api2Doc 注解 可 以 修饰 在 方法 中 。 
@Api2Doc 注解 提供 了 以 下 常用 参数 。 

* name: 定义 名 称 。 

* order: 排序 优先 级 ， 数 字 越 小 ， 越 靠 前 。 

2.ApiComment 


@ApiComment 注解 主要 用 于 对 API 进行 说 明 ， 它 可 以 修饰 在 很 多 地 方 。 当 修饰 在 类 上 时 ， 表 
示 对 当前 API 接口 进行 说 明 ; 当 修 饰 在 方法 上 时 ， 表 示 对 这 个 API 接口 进行 说 明 ; 当 修饰 在 参数 
上 时 ,表示 对 这 个 API 接口 的 请 求 参数 进行 说 明 ; 当 修饰 在 返回 类 型 的 属性 上 时 ， 表 示 对 这 个 APT 
接口 的 返回 字段 进行 说 明 ; 当 修 饰 在 枚 举 项 上 时 ， 表 示 对 枚 举 项 进行 说 明 。@ApiComment 注解 提供 
了 如 下 参数 。 
value: 说 明 。 
seeField: 采用 指定 字段 上 的 说 明 信 息 。 
seeClass: 采用 指定 类 的 同名 字段 上 的 说 明 信 息 。 
sample: 示例 值 。 
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3. ApiError 


@ApiError 用 于 定义 错误 码 和 错误 说 明 ， 包 含 的 属性 如 下 。 
* value: 定义 错误 码 。 
* comment: 定义 错误 说 明 。 


4. ApiErrors 
用 于 组 装 错误 集合 ， 配 合 @ApiError 注解 使 用 。 


11.10.3 Spring Boot 使 用 ApiDoc 


接 下 来 ， 以 实际 项 目 为 例 使 用 ApiDoc。 新 建 项 目 ， 在 项 目 中 加 入 terran4j-commons-api2doc 依 
赖 ， 如 代码 清单 11-32 所 示 。 


代码 清单 11-32 Spring Boot-APIDOC 项 目 依赖 代码 


<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 

</dependency> 

<dependency> 
XgroupId»com.github.terran4j«/groupId» 
XartifactId^terran4j-commons-api2doc«/artifactId» 
«version»1.0.2«/version» 


«/dependency» 


在 启动 类 上 加 入 @EnableApi2Doc 注解 ， 如 代码 清单 11-33 所 示 。 


代码 清单 11-33 Spring Boot-APIDOC 项 目 启动 类 代码 


GSpringBootApplication 
GEnableApi2Doc 
public class ChapterlllOApplication ( 
public static void main(String[] args) ( 
SpringApplication.run(ChapterlllOApplication.class, args); 


} 
创建 实体 类 用 作 API 返回 对 象 ， 如 代码 清单 11-34 所 示 。 


代码 清单 11-34 Spring Boot-APIDOC 项 目 实体 类 代码 


public class User ( 
GApiComment(value = "MP id", sample = "1") 
private Long id; 
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GApiComment(value = "用 户 id"，sample = "dalaoyang") 
private String userName; 


GApiComment(value = "Ħ id", sample = "123") 
private String userPassword; 


..。// 省 略 set, Get 方法 


$ 
最 后 ， 创 建 一 个 UserController 作为 API， 使 用 的 都 是 简单 逻辑 ， 这 里 就 不 做 介绍 了 。 
UserController 内 容 如 代码 清单 11-35 所 示 。 


代码 清单 11-35 Spring Boot-APIDOC Jii Hl API 文档 代码 


GApi2Doc(id = "users", name = "用 户 接口 "，order = 1) 
GApiComment (seeClass = User.class) 

GRestController 

GRequestMapping (value = "/api/vl/users") 


public class UserController ( 
GApi2Doc(order = 1) 
GApiComment ("新 增 用 户 ") 


@ApiErrors ({ 
GApiError(value = "is-exists", comment = "此 用 户 已 经 存在 ! ")， 


GApiError(value = "error", comment = "错误 ! ") 
n 
GPostMapping(name = "新 增 用 户 ",value="/addUser") 
public User addUser( 
GApiComment(value = "HPR", seeField = "id") GRequestParam 


(required = true) Long id, 
GApiComment (value = "用 户 名 称 ", seeField = "userName") GRequestParam 


(required = true) String userName, 
GApiComment(value = "用 户 密码 ", seeField = "userPassword") 
@RequestParam (required = true) String userPassword) ( 
User user - new User(id,userName,userPassword); 


return user; 


) 


GApi2Doc(order = 2) 

GApiComment ("根据 用 户 ID 查询 用 户 ") 

GApiError(value = "not-found", comment = "此 用 户 不 存在 ! ") 

@GetMapping (name = "查询 用 户 "，value = "/getUser/(id]") 

public User getUser(GPathVariable("id") Long id) ( 
return new User(id,"dalaoyang","123"); 
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启动 项 目 ， 访 问 http://localhost:8080/api2doc/home.html， 可 以 看 到 如 图 11-13 所 示 的 页 面 。 
Es 


Api2Doc 接口 文档 


Mr ~ 欢 镍 使 用 Api2Doc | 


图 11-13 ApiDoc 项 目 首页 
单 击 左 侧 菜 单 栏 的 用 户 接口 ， 可 以 看 到 如 图 11-14 所 示 的 页 面 。 


Api2Doc 接口 文档 


- 新 增 用 户 
"m 

API 慰 识 
p 
API 简 介 

， 新 增 用 户 


请 求 DRI 

+ Zapi Zusersodäiser 

请 求 方法 

e POST 

请 天 参数 
sl 
u " LEN CI | 
— " "c WE anome 
eese FS Metu. | nin ara o 


图 11-14 ApiDoc 项 目 新 增 用 户 文档 页 面 1 
在 接口 详情 下 会 有 一 些 调用 的 详细 信息 ， 如 图 11-15 所 示 。 


wea 请 求 示例 《curl 命令 格式 ， 
[ curl, -X POST 
zd, "userPassword-123&id«1&userNane-dal, Ai 
P Thetpz/7Locolhost :0Bd/opi/vi users/addiser" 
返回 数据 示例 


“d:i, 
“username” : "dal. "S 
} "UserPassnord" rad 


返回 数据 说 明 
* Uer (参见 下 面 的 类 型 说 明 ) 


User HR 

ia im Mia 1 
userName arini meia dalaoyang. 
userPasswond sting 用 户 id m 


5 
E 
| 


图 11-15 ApiDoc 项 目 新 增 用 户 文档 页 面 2 


302 | Spring Boot 2 实战 之 旅 
ApiDoc 文档 相 较 于 Swagger 美中不足 的 是 没有 直接 调用 的 地 方 ， 只 有 一 个 文档 供 我 们 查看 ， 
至 于 项 目 中 使 用 哪个 ， 根 据 实 际 情况 选择 即 可 。 


11.11 小 结 


本 章 的 内 容 可 能 比 之 前 几 个 章节 零散 ， 但 是 这 些 功 能 基本 上 都 是 项 目 中 必须 涉及 的 ， 所 以 更 
需要 我 们 了 解 其 使 用 方法 和 功能 ， 从 而 在 项 目 中 使 用 。 


Spring Boot 打包 部 署 


在 之 前 的 章节 中 ， 对 Spring Boot 应 用 程序 与 其 他 常用 工具 进行 了 整合 ， 从 而 创建 了 一 个 完整 
的 应 用 程序 。 本 章 将 对 Spring Boot 应 用 的 几 种 运行 和 部 署 进行 介绍 ， 让 应 用 可 以 在 本 机 或 服务 器 
上 顺利 运行 。 


12.1 使 用 IDE 启动 


关于 Spring Boot 应 用 程序 的 启动 方式 有 很 多 种 ， 对 于 开发 者 来 说 ， 常 用 的 是 使 用 IDE 启动 
Spring Boot 应 用 程序 。 由 于 这 种 方式 比较 简单 , 因此 以 IntelliJ IDEA 为 例 简单 介绍 一 下 如 何在 IDE 
上 运行 Spring Boot 应 用 程序 。 

在 IDE 上 运行 Spring Boot 应 用 程序 主要 分 为 两 种 模式 ， 即 Run 模式 和 Debug 模式 。 其 中 ， 
Run 模式 是 直接 运行 应 用 代码 ; Debug 模式 是 以 调试 模式 运行 代码 ， 可 以 进行 Debug 调试 。 接 下 来 
分 别 介绍 两 种 模式 的 使 用 。 


12.1.1 运行 Spring Boot 应 用 程序 


这 里 以 8.1 节 的 项 目 为 例 ， 在 Intelli) IDEA 中 ， 可 以 直接 单 击 快捷 栏 的 Run 按钮 或 者 Debug 
按钮 来 启动 ， 如 图 12-1 所 示 。 


SpringBoot Book Be chapter8-1 


12-1 IntelliJ IDEA 启动 应 用 按钮 
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单 击 按钮 后 ， 即 可 正常 运行 Spring Boot 应 用 程序 。 当 然 ， 我 们 也 可 以 在 Spring Boot 应 用 程序 
主 类 (Application 类 ) 处 右 击 ， 然 后 选择 Run 模式 或 者 Debug 模式 ， 运 行 main 方法 来 启动 应 用 程 
序 ， 如 图 12-2 所 示 。 


122 在 启动 类 执行 main 方法 启动 程序 
上 述 两 种 模式 可 以 实现 同样 的 效果 ， 在 开发 中 结合 自己 的 喜好 来 使 用 即 可 。 


12.1.2 IntelliJ IDEA 启动 多 实例 


在 开发 测试 功能 的 过 程 中 ， 可 能 有 很 多 时 候 需要 相同 的 项 目 以 不 同 的 端口 启动 。 这 时 ， 有 的 
开发 人 员 可 能 选择 复制 项 目 , 然后 分 别 启动 .其 实在 Intellij IDEA 中 提供 了 单 实例 多 端口 启动 功能 ， 
这 里 还 是 以 8.1 节 的 项 目 为 例 ,首先 启动 项 目 ,当前 端口 为 8080, 然后 在 IntelliJ IDEA 中 单 击 Toolbar 
上 的 编辑 项 目 按钮 ， 单 击 后 选择 Edit Configurations 选项 ， 如 图 12-3 所 示 。 


/chapt 


图 12-3 Edit Configurations 选项 


打开 如 图 12-4 所 示 的 页 面 ， 取 消 选 中 Single instance only 复 选 框 。 


12-4 取消 选中 Single instance only 复 选 框 
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然后 修改 配置 文件 端口 ， 继 续 启动 Spring Boot 应 用 程序 即 可 实现 多 端口 启动 。 


12.2 ”使 用 Maven 启动 


Maven 是 本 书 用 来 构建 Spring Boot 的 主要 工具 ， 其 实 Spring Boot 应 用 也 可 以 使 用 Maven 命 
令 来 构建 。 命 令 如 代码 清单 12-1 所 示 。 


代码 清单 12-1 Maven 启动 Spring Boot 应 用 程序 


mvn spring-boot:run 


使 用 命令 的 时 候 需 要 在 Spring Boot 应 用 程序 根 目 录 ， 这 里 以 8-1 节 的 项 目 为 例 ， 首 先 在 终端 
(命令 行 ) 进入 项 目 根 目录 ， 如 图 12-5 Pros. 


图 12-5 项 目 文件 目录 


然后 在 当前 文件 夹 下 指定 代码 清单 12-1 的 命令 ,就 可 以 启动 Spring Boot 应 用 程序 (注意 : 需 
要 配置 Maven 环境 变量 ) 。 


12.3 JAR 形式 启动 


JAR 形式 运行 和 部 署 Spring Boot 应 用 是 Spring Boot 一 个 比较 大 的 亮点 ， 其 内 髓 的 Web 容器 
起 着 重要 的 作用 。 接 下 来 ， 介 绍 Spring Boot 应 用 程序 如 何以 JAR 包 形 式 启动 。 


12.3.1 使 用 命令 将 Spring Boot 应 用 程序 打 成 JAR 


使 用 12.2 节 的 目录 ， 分 别 利 用 以 下 3 个 命令 进行 打包 。 

© mvnclean package: 命令 完成 了 项 目 编译 、 单 元 测试 、 打 包 。 

e mvn clean install: 命令 不 但 完成 了 项 目 编译 、 单 元 测试 、 打 包 ， 还 将 打 好 的 JAR 包 部 署 到 本 
地 Maven 仓库 。 

e mvnclean depoly: 命令 不 但 完成 了 项 目 编译 、 单 元 测试 、 打 包 ， 还 将 打 好 的 JAR 包 部 署 到 本 
地 Maven 仓库 和 远程 Maven 私服 仓库 。 


在 使 用 命令 打 好 JAR 包 之 后 ， 在 目录 下 会 生成 一 个 target 文件 夹 ， 进 入 文件 夹 后 可 以 看 到 打 
好 的 JAR 包 ， 如 图 12-6 所 示 。 
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图 12-6 项 目 文件 JAR 文件 目录 


其 中 ，chapter8-1-0.0.1-SNAPSHOT.jar 就 是 这 里 需要 使 用 的 JAR 包 文件 ， 然 后 以 java -jar JAR 
文件 名 称 的 形式 启动 JAR 包 ， 具 体 启动 命令 如 代码 清单 12-2 所 示 。 


代码 清单 12-2 ”命令 行 启动 Spring Boot 应 用 程序 


java -jar chapter8-1-0.0.1-SNAPSHOT.jar 


执行 命令 后 即 可 正确 启动 Spring Boot 应 用 程序 。 
当然 ，Spring Boot 应 用 程序 JAR 形式 启动 可 以 指定 一 些 参数 ， 分 别 说 明 如 下 。 


指定 端口 : java -jar xxxjar -server.port-8888. 

内 存 参数 : java -Xms800m -Xmx800m -XX:PermSize-256m -XX:MaxPermSize-512m -XX: 
MaxNewsSize-512m -jar xxx.jar« 

配置 文件 : java -jar xxx.jar -Dspring.profiles.active-dev 

后 台 运 行 : nohup java -jar xxx jar &。 


常用 命令 还 有 很 多 ， 这 里 只 列 出 了 一 小 部 分 ， 仅 供 参 考 。 


12.3.2 IntelliJ IDEA 3T JAR 包 


在 IntelliJ IDEA 内 打 JAR 包 比较 简单 ， 直 接 在 工具 栏 Maven Projects 对 应 项 目 单 击 package, 
install 或 deploy 按钮 即 可 例如 ， 单 击 package 按钮 的 效果 等 同 于 执行 mvn package 命令 ) ， 如 图 
12-7 所 示 。 


v 项 chapter8-1 
VI 


12-7 IntelliJ IDEA 内 的 Maven 插件 列表 
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单 击 对 应 按钮 后 ， 后 续 操作 还 是 使 用 java -jar JAR 文件 名 称 来 执行 应 用 程序 。 


124 War 形式 启动 


传统 的 Java Web 应 用 程序 一 般 都 是 在 应 用 开发 完成 之 后 将 应 用 程序 打包 成 War 包 , 然后 部 署 
到 Tomcat、WebLogic 等 Web 容器 下 。 对 于 Spring Boot 应 用 程序 来 说 ， 虽然 提供 了 JAR 形式 的 部 
署 ， 但 是 也 支持 使 用 War 包 部 署 。 接 下 来 ， 笔 者 将 带领 大 家 学 习 如 何 使 用 War 部 署 Spring Boot 
应 用 程序 。 


12.4.1 创建 项 目 


新 建 一 个 Spring Boot WA, AIX Spring Boot 应 用 程序 默认 是 使 用 Tomcat 容器 的 ， 而 我 们 这 
次 需要 打 War 包 的 形式 部 署 到 Tomcat, 所 以 需要 在 pom 文件 中 移 除 spring-boot-starter-tomcat 依赖 ， 
并 且 加 入 spring-boot-starter-web 依赖 ， 便 于 我 们 进行 测试 ， 如 代码 清单 12-3 所 示 。 


代码 清单 12-3 Spring Boot 应 用 程序 War 部 署 依赖 文件 代码 


<dependencies> 
<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 
</dependency> 
<dependency> 
XgroupId»org.springframework.boot«/groupId» 
XartifactId»spring-boot-starter-tomcat«/artifactId» 
Xscope»provided«/scope» 
</dependency> 
</dependencies> 


接 下 来 ， 创 建 一 个 ServletInitializer 类 ， 继 承 SpringBootServletInitializer 类 来 实现 configure 方 
法 ， 如 代码 清单 12-4 所 示 。 


代码 清单 12-4 Spring Boot 应 用 程序 War 部 署 Servletinitializer 类 代码 


Public class ServletInitializer extends SpringBootServletInitializer { 


@Override 
protected SpringApplicationBuilder configure (SpringApplicationBuilder 
application) ( 
return application.sources (Chapterll4Application.class); 
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其 实 ， 到 这 里 就 已 经 配置 完成 了 。 不 过 我 们 需要 创建 一 个 Controller 进行 测试 ， 这 里 创建 一 个 
IndexController， 里 面 写 一 个 简单 的 返回 字符 串 便于 测试 ， 如 代码 清单 12-5 所 示 。 


代码 清单 12-5 Spring Boot 应 用 程序 War 部 署 IndexController 类 代码 


@RestController 


public class IndexController { 


GGetMapping("/") 
public String index()( 

return "SpringBoot War Application !"; 
$ 


12.4.2 $7 War 包 部 署 到 Tomcat 


配置 完成 后 ， 使 用 12.3 dT JAR 包 的 方法 将 项 目 打 成 WAR 包 。 这 里 以 终端 执行 为 例 ， 执 行 
myn clean install 后 ， 查 看 项 目 内 的 target 文件 夹 ， 如 图 12-8 所 示 。 


图 12-8 项 目 文件 War 文件 目录 


接 下 来 ,我 们 把 chapter11-4-0.0.1-SNAPSHOT.war 文件 放 入 Tomcat 应 用 的 webapps 文件 夹 下 ， 
如 图 12-9 所 示 。 


图 12-9. Tomcat 文件 夹 webapps 文件 目录 


最 后 ， 进 入 Tomcat 应 用 bin 目录 执行 命令 ./startup.sh 来 启动 Tomcat。 关 于 测试 ， 这 里 就 不 演 
示 了 ， 感 兴趣 的 读者 可 以 自行 测试 。 


12.5 ”使 用 Docker 构建 Spring Boot 项 目 


现 如 今 很 多 公司 部 署 服 务 都 使 用 容器 部 署 ， 而 Docker 正 是 这 一 领域 的 佼佼 者 。 接 下 来 笔者 将 
介绍 如 何 使 用 Docker 部 署 Spring Boot 应 用 。 
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12.5.1 Docker 简介 


Docker〈 官 网 地 址 : https://www.docker.com/) 是 一 个 开源 的 应 用 容器 引擎 ， 让 开发 者 可 以 打 
包 其 应 用 及 依赖 包 到 一 个 可 移植 的 容器 中 ,然后 发 布 到 任何 流行 的 Linux 机 器 上 。 也 可 以 实现 虚拟 
化 ， 容 器 是 完全 使 用 沙 箱 机 制 的 ， 相 互 之 问 不 会 有 任何 接口 。 

Docker 基于 Linux 内 核 的 CGroup、Namespace 技术 ， 对 进程 进行 封装 隔离 ， 可 以 使 Linux 服 
务 器 最 大 化 地 发 挥 性 能 。 接 下 来 我 们 看 一 下 如 何 利 用 Docker 构建 Spring Boot 应 用 程序 。 


12.5.2 ”安装 Docker 


首先 需要 有 一 个 Docker 环境 。 安 装 Docker 很 简单 ， 这 里 以 mac 为 例 ， 在 终端 执行 命令 ， 如 
代码 清单 12-6 所 示 。 


代码 清单 12-6 Mac 安装 Docker 命令 


brew cask install docker 


安装 完成 后 ， 在 应 用 程序 内 启动 Docker.app 即 可 。 


12.5.3 Dockerfile 


使 用 Docker 构建 Spring Boot 应 用 程序 需要 创建 一 个 Dockerfile 文件 (没有 后 缀 ) 。 这 里 以 8-1 
节 的 项 目 为 例 ， 进 入 target 文件 夹 创建 Dockerfile 文件 ， 内 容 如 代码 清单 12-7 所 示 。 


代码 清单 12-7 Dockerfile 文件 内 容 


FROM java:8 

VOLUME /tmp 

ADD chapter8-1-0.0.1-SNAPSHOT.jar /test.jar 

ENTRYPOINT 
["java","-Djava.security.egd-file:/dev/./urandom","-jar","/test.jar"] 


下 面 对 Dockerfile 进行 简单 介绍 。 


第 1 行 : java:8 使 用 jdk 版 本 。 

第 2 行 : 临时 文件 目录 。 

第 3 fT: chapter8-1-0.0.1-SNAPSHOT, jar 是 JAR 文件 内 容 。 

第 4 行 : ENTRYPOINT 执行 JAR 文件 12.5.4 生成 Docker 镜像 。 


接 下 来 ， 通 过 命令 生成 Docker 镜像 ， 如 代码 清单 12-8 所 示 。 
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代码 清单 12-8 Dockerfile 文件 内 容 


docker build -t test . 


构建 Docker 镜像 test， 执 行 后 如 图 12-10 所 示 ， 就 执行 成 功 了 。 


12-10 docker build 执行 结果 


当然 ， 也 可 以 通过 docker images 查看 是 否 生成 Docker 镜像 ， 查 询 结果 如 图 12-11 所 示 。 


图 12-11 docker images 执行 结果 


12.5.4 ”运行 Docker 镜像 


执行 Docker 镜像 只 需要 执行 docker run 命令 即 可 ， 其 中 可 以 通过 -d 来 指定 后 台 运 行 ，-p 来 指 
定 容器 内 端口 以 及 服务 器 端口 ， 最 后 指定 运行 的 镜像 名 称 。 完 整 运行 Docker 镜像 的 代码 如 代码 清 
单 12-9 所 示 。 


代码 清单 12-9 运行 Docker 镜像 代码 


docker run -d -p 8080:8080 test 


运行 后 ， 在 浏览 器 访问 http://localhost:8080/actuator/health， 可 以 看 到 如 下 结果 : 


{"status" :"DOWN", "details":{"my":{"status":"DOWN", "details":{"Error 
Code:":500}},"diskSpace":{"status":"UP","details":{"total":62725623808, "free" 
:57663266816, "threshold":10485760}}}} 


到 这 里 ， 使 用 Docker 运行 Spring Boot 应 用 就 完成 了 。 更 多 Docker 命令 可 以 在 官网 中 查看 。 
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12.6 使 用 Jenkins 自动 化 部 署 Spring Boot 应 用 


当 服 务 逐 渐 扩 张 ， 部 署 变 成 了 一 道 难 题 ， 自 动 化 部 署 随 之 流行 。Jenkins 是 自动 集成 部 署 项 目 
的 优秀 产品 ， 本 节 将 介绍 Spring Boot 如 何 通过 Jenkins 进行 自动 部 署 。 


12.6.1 Jenkins 简介 


Jenkins《〈 官 网 地 址 : https://jenkins.io/) 是 一 个 由 Java 语言 开发 的 持续 集成 交付 的 项 目 。 无 论 
是 什么 语言 构建 的 项 目 ， 几 乎 都 可 以 通过 Jenkins 部 署 ， 并 且 Jenkins 的 安装 非常 简单 ， 只 要 是 拥有 
Java 环境 的 服务 器 或 者 开发 环境 ， 都 可 以 通过 下 载 WAR 的 形式 直接 启动 运行 。 


12.6.2 Spring Boot 应 用 使 用 Jenkins 


本 节 介 绍 Jenkins 从 Git 平台 拉 取 项 目 代码 , 然后 将 项 目 构建 成 JAR 包 文件 , 最 后 通过 执行 Shell 
来 启动 Spring Boot 应 用 程序 。 这 里 使 用 的 Git 项 目 是 托管 在 码 云 上 的 项 目 ， 可 以 免费 供 大 家 使 用 ， 
页 面 地 址 是 https://gitee.com/dalaoyang/Test-Jenkins, Git 地 址 是 https://gitee.com/dalaoyang/Test-Jenkins。 

1. 安装 Jenkins 

直接 通过 Jenkins 官网 (下 载 地 址 : https://jenkins.io/download/) 下 载 最 新 版 本 的 Jenkins, fA 
后 选择 喜欢 的 方式 安装 即 可 。 

2. Jenkins 插件 

这 里 使 用 Jenkins 的 Maven 插件 和 Git 插件 ， 在 “系统 管理 ”一 “插件 管理 ”处 下 载 即 可 ， 如 
图 12-12 所 示 。 


$ Jenkins 


Version 。 metaled 


Page genreratot: 2018-12-16 下 0157940M。 RESTAPI Jkoknayar 2.152 


12-12 Jenkins 插件 页 面 
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3. 全 局 工具 配置 


在 全 局 工具 配置 处 配置 服务 器 或 者 物理 机 的 JDK、Git 和 Maven 环境 变量 ， 如 图 12-13 所 示 。 


12-13 Jenkins 全 局 工具 配置 页 面 


4. 构建 项 目 


创建 一 个 自由 风格 的 软件 项 目 即 可 , 然后 为 应 用 起 一 个 名 称 , 这 里 起 名 为 Spring Boot-Project， 


如 图 12-14 所 示 。 


Enter an item name 
SpringBoot-Project 


ET 


和 的 理 一 个 多 配置 项 目 
) amz senma posmam, 


x) 


IM you want to create a new tem from other existing, you can use this option: 


YA oron ve 


图 12-14 Jenkins 构件 项 目 页 面 


然后 单 击 下 方 的 OK 按钮 。 其 实 构建 项 目 很 简单 ， 先 创建 几 个 参数 ， 选 择 参数 化 构建 ， 如 图 


12-15 和 图 12-16 所 示 。 
使 用 的 参数 〈 其 实 构建 参数 不 是 必须 要 这 样 做 ， 只 是 方便 后 面 使 
可 以 略 过 ) 说 明 如 下 。 
* JAR NAME: Spring Boot 应 用 程序 打 成 JAR 包 后 的 文件 名 称 。 
* CHECK URL: 测试 项 目 是 否 启动 成 功 的 地 址 。 
* JDK PATH: JDK 地 址 ， 启 动 JAR 时 使 用 。 


1 。 由 于 范例 项 目 比 较 简单 ， 
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mim 
e 
e 
sem 加 © 
Name JAR NAME e 
Doit Vale | tes jer 00.1. SNAPSHOT jer e 
Description e 
TEE Prev m 
Tóm he sting e 
— LES 
Name CHECK URL e 
Detaut Vahe | htp Wocahost10001 e 
Description e 
DER] Preview E 
Tem he string e 
Em - 
- a u,. 


图 12-15 Jenkins 参数 化 构建 页 面 -1 


字符 参数 e 
Name JDK. PATH e 
Defaut Value | /usrlbin/java LJ 
Description @ 
[56 5.5] Preview 
Trim the string e 
Add Parameter » 


图 12-16 Jenkins 参数 化 构建 页 面 -2 


接 下 来 配置 Git 应 用 (本 文 的 Git 是 公开 项 目 ， 所 以 无 须 配 置 用 户 名 、 密 码 等 信息 ， 如 果 需 要 
校 验 权限 ， 就 需要 配置 用 户 名 和 密码 ) ， 如 图 12-17 所 示 。 


erin ET 


source Code Management 
Source Code Management 


rr 


Repositories © 
Reposkory URL hmpejgaee comdalaoyang Test Jankóns gt o 


Dededas -无 rm 
Advanced 


Add Repostory 


p B 


Branch Specifier (blank for ‘any) | "master e 


Repository browser — (Auto) 4e 


图 12-17 Jenkins-Git 配置 
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最 后 ， 我 们 只 需要 在 Build 部 分 配置 需要 执行 的 命令 即 可 ， 如 代码 清单 12-10 所 示 。 


代码 清单 12-10 Build 执行 脚本 


# 程 序 打包 ， 跳 过 test 文件 

mvn clean install -Dmaven.test.skip-true; 

HAG shell 启动 应 用 程序 

/Users/dalaoyang/Downloads/startup.sh $JAR NAME $CHECK URL $WORKSPACE 
$JDK PATH 


上 面 的 命令 中 ,我 们 通过 对 应 用 打包 , 然后 执行 了 一 个 脚本 并 且 传 入 了 4 个 参数 ,其 中 startup.sh 
如 代码 12-11 清单 所 示 。 


代码 清单 12-11 Build 执行 脚本 


# 保 证 Jenkins 进程 不 被 杀 掉 
export BUILD ID=dontKillMe 


JAR NAME=${1} 
CHECK URL-$(2) 
WORKSPACE-$ (3) 
JDK PATH-$(4) 


if [ ! -n "$(JAR NAME)" ] ;then 
echo "参数 1. JAR NAME 为 空 " 
exit 1 

fi 

if [ ! -n "${CHECK_URL}" ] ;then 
echo "参数 2. CHECK_URL 为 空 " 
exit 1 

[Em 

if [ ! -n "S(WORKSPACE]" ] ;then 
echo "参数 3. WORKSPACE 为 空 " 
exit 1 

Ei 

if [ ! -n "S(JDK PATH)" ] ;then 
echo "参数 4. JDK PATH NE" 
exit 1 

fi 


PID=`ps -ef |grep $(JAR NAME) |grep -v grep | awk '(print $2)'^ 
if [ ! "SPID" ];then # 这 里 判断 当前 JAR 进程 是 否 存在 
echo "进程 不 存在 " 


else 
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echo "进程 存在 杀 死 进程 PID$PID" 
kill -9 $PID 


fi 


# 后 台 启 动 jar 
echo "服务 启动 中 " 
nohup $(JDK PATH) -jar ${WORKSPACE}/target/${JAR NAME) & 


# 服 务 检查 
CHECK ATTEMPTS-20 
CHECK TIMEOUT-6 


# 服 务 启动 检测 
ONLINE=false 
echo "检测 服务 启动 状态 " 
for (( i-1; i<=${CHECK ATTEMPTS); i++ )) 
do 
CODE-'curl -sL --connect-timeout 20 --max-time 30 -w "$(http code) Wn" 
"S(CHECK URL)" -o /dev/null^ 
echo "服务 检测 返回 结果 : SCODE" 
if [ "S(CODE)" = "200" ]; then 
echo "已 检测 到 服务 : S(CHECK URL)" 
sleep 10 
ONLINE=true 
break 
else 
echo "未 检测 到 服务 ， 等 待 $S{CHECK TIMEOUT) 秒 后 重 试 " 
Sleep $(CHECK TIMEOUT} 
£i 
done 
if $ONLINE; then 
echo "服务 检查 结束 ， 服 务 启动 正常 " 
exit 0 
else 
echo "服务 检查 结束 ， 服 务 启动 失败 " 
exit 1 
Ei 


解释 一 下 脚本 内 容 ， 大 致 分 为 如 下 几 步 : 
(1) 在 Jenkins 默认 配置 下 ， 执 行 完成 后 会 杀 死 所 有 子 进程 ， 所 以 即使 是 使 用 nohup 启动 的 
Java 程序 ， 也 会 被 关闭 ， 所 以 在 文件 开始 就 指定 当前 进程 不 被 关闭 。 
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(2) 环境 参数 的 校 验 ， 因 为 参数 都 是 需要 使 用 的 ， 所 以 这 里 的 校 验 不 能 为 空 。 

(3) 判断 当前 JAR 是 否 已 经 被 启动 ， 如 果 已 经 启动 ， 再 次 启动 就 会 无 法 启动 ， 所 以 先 检查 是 
否 有 当前 JAR 文件 的 端口 ， 如 果 有 ， 就 先 关 闭 。 

(4) 使 用 nohup 后 台 启 动 JAR. 

C5) 判断 服务 是 否 成 功 启动 。 这 里 是 通过 请 求 应 用 程序 的 一 个 路 径 ， 如 果 请 求 成 功 ， 就 认为 
启动 正常 ， 否 则 启动 失败 。 

5. 启动 应 用 程序 


单 击 Build with Parameter 按钮 ， 如 图 12-18 所 示 ， 然 后 单 击 下 方 的 Build 按钮 。 


$ Jenkins 2 

Jorns ， SpingBook Project 

di Back to Dashboard. ik 4 : 
工程 SpringBoot-Project 

Status 

Tis buld game parameters: 

Er Changer 

m JAR_NAME yose jenkins-0.0.1-SNAPSHOT jar 

ID Buid wih Parameters CHECK URL ya /hocahost10001/ 

© ooo IE OK pm tinta 

LE contgure Ee 

J copy 工程 
(Br Prae 
Bud History mde 


图 12-18 Jenkins- 启 动 应 用 程序 页 面 
然后 查看 控制 台 ， 可 以 看 到 如 图 12-19 所 示 的 内 容 。 


initialized with port(s): 10001 (http) 

2018-12-16 13:43:47.080 INFO 6929 --- | main] o.apache.catalina.core.StandardService : Starting 
service [Tomcat] 

2018-12-16 13:43:47.080 INFO 6929 
Servlet Engine: Apache Tomcat/9.0.13 

2018-12-16 13:43:47.112 INFO 6929 --- | main] o.s.catalina.core.AprLifecycleListener : The APR based 


x main] org.apache.catalina.core.StandardEngine : Starting 


Apache Tomcat Native library which allows optimal performance in production environments was not found on the 
java.library.path: 
[/Users/dalaoyang/Library/Java/Extensions:/Library/Java/Extensions:/Network/Library/Java/Extensions:/System/Librar 
y/Java/Extensions:/usr/lib/java:.] 


2018-12-16 13:43:47.254 INFO 6929 --- | main] o.a.c.c.C. [Tomcat]. [1ocalhost].[/] : Initializing 
Spring embedded WebApplicationContext 

2018-12-16 13:43:47.255 INFO 6929 --- | main] o.s.web.context.ContextLoader : Root 
WebapplicationContext: initialization completed in 2350 ms 

2018-12-16 13:43:47.608 INFO 6929 --- | main] o.s.s.concurrent.ThreadPoolTaskExecutor : Initializing 
ExecutorService 'applicationTaskExecutor' 

2018-12-16 13:43:47.999 INFO 6929 --- | main] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat started 
on port(s): 10001 (http) with context path '' 

2018-12-16 13:43:48.006 INFO 6929 --- | main] com.dalaoyang.TestJenkinsApplication : Started 
TestJenkinsApplication in 3.894 seconds (JVM running for 4.599) 

2018-12-16 13:43:49.614 INFO 6929 --- [io-10001-exec-1] o.a.c.c.C.[Tomcat].[1ocalhost].[/] : Initializing 
Spring DispatcherServlet 'dispatcherServlet" 

2018-12-16 13:43:49.614 INFO 6929 --- [io-10001-exec-1] o.s.web.servlet.DispatcherServlet : Initializing 
Servlet 'dispatcherServlet' 

2018-12-16 13:43:49.623 INFO 6929 —- [io-10001-exec-1] o.s.web.servlet.DispatcherServlet : Completed 
initialization in 9 ms 

服务 检测 返回 结果 : 200 


已 检测 到 服务 : htt 
服务 检查 结束 ， 服 务 上 
Process leaked file descriptors. See https://jenkins.io/redirect/troubleshooting/process-leaked-file-descriptors 
for more information 

Finished: SUCCESS 


L/19calhost:10001/ 
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12-19 Jenkins- 启 动 控制 台 页 面 
在 浏览 器 访问 http://localhost:10001， 可 以 看 到 控制 台 有 如 下 输出 : 
SpringBoot-Jenkins-Project 
Jenkins 可 以 做 的 还 有 很 多 , 案例 中 只 是 通过 Jenkins 拉 取 代码 在 本 地 执行 ， 其实 还 可 以 发 布 到 
远程 服务 器 ， 在 Jenkins 配置 好 远程 服务 器 ， 然 后 将 JAR 或 者 WAR 文件 及 Shell 脚本 发 送 过 去 执 
行 即 可 。 由 于 篇 幅 原因 ， 这 里 不 再 袭 述 。 


12.7 小 结 


本 章 对 Spring Boot 项 目的 运行 和 部 署 进行 了 学 习 ， 并 且 介 绍 了 如 何 使 用 Jenkins 自动 化 部 署 
Spring Boot 应 用 。 相 信 经 过 本 章 的 学 习 ， 读 者 对 Spring Boot 应 用 程序 的 部 署 已 经 游 九 有余 ， 可 以 
在 实际 工作 中 部 署 时 得 心 应 手 。 


Spring Boot 实战 之 博客 系统 


前 面 的 章节 对 Spring Boot 进行 了 阶段 性 的 学 习 ， 本章 将 进行 实战 演练 ， 利 用 Spring Boot 框架 
制作 一 个 博客 系统 。 


13.1 博客 的 制作 思路 


很 多 开发 者 都 喜欢 利用 一 些 平台 进行 技术 分 享 ， 如 CSDN、 简 书 、 掘 金 等 。 当 然 ， 也 有 很 多 
发 者 喜欢 制作 属于 自己 的 博客 进行 技术 分 享 ， 如 今 比 较 常用 的 开源 博客 有 Hexo 和 WordPress. 
虽然 这 些 开源 博客 都 很 不 错 , 但 是 作为 开发 者 ,开发 一 个 个 人 博客 也 是 很 有 意思 的 事情 。 本 章 将 带 
领 大 家 开发 一 个 属于 自己 的 博客 系统 。 

制作 博客 的 思路 分 为 如 下 几 步 : 

CD 静态 模板 项 目 制 作 ， 将 HTML 静态 项 目 改 为 Thymeleaf 项 目 ， 使 用 Controller 进行 跳 转 。 
(2) 实体 设计 ， 因 为 使 用 的 是 Spring Data JPA， 实 体 设 计 会 决定 数据 库 表 的 结构 。 

(3) 后 台 方 法 代码 编写 ， 包 含 查询 数据 库 、 封 装 数据 等 。 

(4) 泻 染 数据 ， 将 后 台 查 询 出 来 的 数据 动态 泻 染 到 Thymeleaf。 


13.1.1. 博客 布局 介绍 
以 从 网 上 下 载 的 静态 博客 模板 为 例 ， 首 先 来 看 博客 的 布局 设计 。 博 客 的 首页 分 为 上 、 中 、 下 3 
部 分 ， 其 中 上 方 和 下 方 是 本 博客 的 公共 部 分 ， 中 间 则 为 每 个 导航 动态 显示 的 内 容 ， 分 别 说 明 如 下 。 


DEA 
左边 是 博客 的 LOGO， 这 里 以 笔者 的 网 名 为 例 ， 当 然 读者 也 可 以 根据 自己 的 网 名 或 喜欢 的 名 
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称 给 博客 命名 ， 单 击 博客 LOGO 返回 博客 首页 。 右 边 是 文章 的 导航 栏 ， 导 航 栏 分 为 5 个 模块 ， 即 
首页 、 博 客 页 、 搜 索 页 、 关 于 页 和 联系 页 ， 单 击 后 可 跳 转 至 对 应 模块 。 导 航 栏 如 图 13-1 所 示 。 


文章 列表 博客 博 主 介绍 


6 篇 TOP 文章 搜索 文章 列表 留 消息 联系 博 主 
图 13-1 导航 栏 
(2) 中 间 
内 容 为 各 个 模块 或 功能 显示 的 内 容 ， 稍 后 会 详细 介绍 。 
(3) 下 方 


下 方 分 为 三 部 分 ， 左 边 是 标签 列表 ， 单 击 标签 列表 中 的 标签 会 进入 标签 列表 页 ， 单 击 标签 列 
表 页 中 的 某 个 标签 会 进入 当前 标签 对 应 的 文章 列表 页 。 中 间 为 友情 链接 列表 页 , 单 击 链接 名 会 跳 转 
至 对 应 的 地 址 。 右 边 为 网 站 的 简介 , 这 里 只 配置 了 博客 的 域名 和 备案 号 ， 读 者 可 以 根据 自己 的 需求 
进行 配置 。 


13.1.2 ”博客 功能 介绍 


博客 功能 其 实 就 是 页 面 中 间 部 分 显示 的 内 容 ， 分 为 以 下 几 个 功能 。 


CD 首页 : 首页 显示 的 内 容 为 博客 中 最 后 置顶 的 6 篇 文章 。 

(2) 博客 页 :显示 博客 中 的 10 篇 文章 ， 显 示 内 容 包含 文章 标题 、 文 章 作者 、 头 像 、 文 章 简 
介 ， 本 页 包含 分 页 。 

G) 搜索 页 : 显示 博客 中 根据 关键 字 搜 索 出 的 10 篇 文章 ， 显 示 内 容 包 含 文章 标题 、 文 章 作 
者 、 头 像 、 文 章 简介 ， 本 页 包含 分 页 。 

(4) 关于 页 : 关于 博 主 的 介绍 ， 这 里 可 以 根据 系统 配置 设置 一 篇 文章 为 关于 页 的 内 容 。 

(5) 联系 页 : 可 以 发 送 一 条 消息 留言 给 博 主 。 

(6) 标签 列表 页 : 显示 全 部 标签 ， 无 分 页 。 

(7) 标签 对 应 博客 页 : 根据 选择 的 标签 名 称 显示 对 应 博客 列表 ， 和 暂 无 分 页 ， 读 者 需要 可 以 加 
分 页 。 

(8) 文章 详情 页 : 显示 文章 的 详细 内 容 。 
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13.2 ”博客 模板 制作 


本 章 博客 系统 使 用 模板 框架 Thymeleaf。 接 下 来 简单 介绍 如 何 将 静态 HTML 页 面 项 目 修改 为 
Thymeleaf 静态 项 目 。 

这 里 需要 提取 4 个 公共 模块 ， 提 取 公 共 模 块 与 提取 公共 方法 的 原因 一 致 ， 为 了 避免 项 目 内 有 
太 多 宛 余 代码 ， 方 便 后 期 修改 。 这 里 的 公共 模块 分 别 说明 如 下 。 
公共 头 模 块 : 主要 用 于 引入 CSS 资源 和 头 部 信息 。 
公共 导航 模块 : 主要 用 于 引入 导航 。 
公共 底部 模块 : 主要 用 于 底部 信息 。 
公共 Js 模块 : 主要 用 于 引入 JS 资源 。 


这 里 以 首页 为 例 ， 其 他 页 面 的 方法 类 似 。 首 先 制作 一 个 公共 头 模块 ， 新 建 HTML 页 面 ， 这 里 
设置 名 称 为 common_head.html， 将 对 应 资源 放 入 ， 使 用 th:fragment 标明 当前 模块 的 名 称 ， 如 代码 
清单 13-1 所 示 。 


代码 清单 13-1 博客 实战 项 目 -公共 头 模块 内 容 


<html xmlns-"http://www.w3.org/1999/xhtml" xmlns:th- 
"http://www.thymeleaf.org"» 
<!DOCTYPE html» 
<html lang-"en"» 
Xhead th:fragment-"commonHeader"» 
«meta charset-"utf-8"» 
«meta http-equiv-"X-UA-Compatible" content-"IE-edge"» 
«meta name-"viewport" content-"width-device-width, initial-scale-1.0"» 
<meta name-"description" content-""» 
«meta name-"author" content-""» 
<title> 这 是 一 个 模板 博客 </title> 
<link rel="stylesheet" th:href="@{/css/bootstrap.css}" type="text/css"> 
<link rel="stylesheet" th:href="@{/css/main.css}" type="text/css"> 
<link rel="stylesheet" th:href="@{/css/page.css}"> 
<link rel="stylesheet" th:href="@{/css/search.css}"> 
<link rel="stylesheet" th:href="@{/font-awesome-4.4.0/css/ 
font-awesome.min.css}"> 


</head> 
</html> 


接 下 来 制作 其 他 3 个 公共 模块 ， 新 建 原理 与 公共 头 模块 一 致 。 公 共 导 航模 块 如 代码 清单 13-2 
所 示 。 
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青 单 13-2 ”博客 实战 项 目 -公共 导航 模块 


<html xmlns-"http://www.w3.0rg/1999/xhtml" 
xmlns:th-"http://www.thymeleaf.org"» 
<div th:fragment-"commonNavigation"» 
<div class-"navbar navbar-inverse navbar-static-top"» 
<div class-"container"» 
<div class-"navbar-header"» 
<button type="button" class-"navbar-toggle" 
data-toggle-"collapse" data-target=" .navbar-collapse"> 


<span class="icon-bar"></span> 


<span clas icon-bar"»«/span» 
<span class 


X/button» 


icon-bar"»«/span» 


«a class-"navbar-brand" th:href="@{index}">DALAOYANG</a> 
«/div» 
«div class-"navbar-collapse collapse"» 
<ul class="nav navbar-nav navbar-right"» 
<li><a th:href="@{/index}"> 首 页 </a></1i> 
<li><a th:href="@{/blog}"> 博 客 </a></1i> 
<li><a th:href="@{/search}"> 搜 索 </a></1i> 
<li><a th:href="@{/about}"> 关 于 </a></1i> 
<li><a th:href="@{/contact}"> 联 系 </a></1i> 
</ul> 
</div> 
</div> 
</div> 
</div> 


公共 底部 模块 如 代码 清单 13-3 所 示 。 


博客 实战 项 目 -公共 底部 模块 内 容 


<html xmlns="http://www.w3.0rg/1999/xhtml" 
xmlns:th="http://www.thymeleaf.org"> 
<div th:fragment="commonFooter"> 
<div id="footer"> 
<div class="container"> 
<div class="row"> 
<div class-"col-lg-4"» 
<h4><a th:href="@{/tag}"> 标 签 </a></h4> 
<p class="footer-tags"> 
<a>SpringBoot</a> 
<a>SpringCloud</a> 
<a>Nginx</a> 
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<a>Linux</a> 
<a>Mybatis</a> 
<a>Spring Data Jpa</a> 
<a>JDBC</a> 
<a>Eureka</a> 

«/p» 


«/div» 


<div class-"col-1lg-4"» 
<h4> 友 情 链 接 </h4> 
<p> 
<a href-"https://blog.csdn.net/qq 33257527"» 
CSDN«/a»Xbr/» 
<a href="https://www.jianshu.com/u/128b6effde53"> 简 书 
</a><br/> 
«a href="https://www.imooc.com/u/6841077"> 幕 课 网 </a> 
</p> 
</div> 
<div class="col-1g-4"> 
<h4> 关 于 网 站 </h4> 
<p>Copyright © 2018. Dalaoyang.cn </p> 
<p>All rights reserved.</p> 
<p> 辽 ICP 备 17014944 号 -1</p> 


</div> 
</div> 


</div> 
</div> 
</div> 


公共 JS 模块 如 代码 清单 13-4 所 示 。 


代码 清单 13-4 ”博客 实战 项 目 -公共 JS 模块 内 容 


<html xmlns-"http://www.w3.org/1999/xhtml" 
xmlns:th-"http://www.thymeleaf.org"» 


<!DOCTYPE html» 

<html lang-"en"» 

<body> 

<div th:fragment="onLoadJs"> 
<l== jQuery -=> 


<script th:src="@{/js/jquery-1.10.2.min.js}"></script> 
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Xscript type-"text/javascript" th:src="@{/js/bootstrap.min.js}"> 
</script> 
<!-- Custom Theme JavaScript --> 
<script th:src="@{/js/page.js}"></script> 
<script th:src-"G(/js/hover.zoom.js)"»«/script» 
<script th:src="@{/js/hover.zoom.conf.js}"></script> 
<!-- HTML5 shim and Respond.js IE8 support of HTML5 elements and media 
queries --> 
l==[if It IB 9]> 
<script th:src="@{/js/html5shiv.js}"></script> 
<script th:src="@{/js/respond.min.js}"></script> 
<! [endif] --> 
</div> 
</body> 
</html> 


接 下 来 看 一 下 首页 的 代码 。 使 用 th:include 引入 对 应 资源 ， 方 式 为 th:include=" 公 共 模 块 位 置 :: 
公共 模块 名 称 "， 完 整 内 容 如 代码 清单 13-5 所 示 。 


代码 清单 13-5 ”博客 实战 项 目 -首页 内 容 


<html xmlns-"http://www.w3.0rg/1999/xhtml" 
xmlns:the"http://www.thymeleaf.org"» 
<html lang-"en"» 


<head th:include-"common/common head::commonHeader"»«/head» 
<body> 


<div th:include="common/common_navigation :: commonNavigation"></div> 
<div class="container pt"> 
<div class="row mt centered"> 
<div class="col-1g-4"> 
<a class-"zoom green" th:href="@{/articleDetailDemo}"><img 
class-"img-responsive" th:src-"((/img/portfolio/port01.jpg]" alt-"" /></a> 
<p>SpringBoot</p> 
</div> 
<div class="col-1g-4"> 
<a class-"zoom green" th:href-"G(/articleDetailDemo)"»«img 
class-"img-responsive" th:src-"((/img/portfolio/port02.jpg]" alt-"" /></a> 
«p»SpringCloud«/p» 
«/div» 
<div class-"col-1g-4"» 
<a class-"zoom green" th:href-"Q(/articleDetailDemo)"»«img 
class-"img-responsive" th:src-"QG(/img/portfolio/port03.jpg)" alt-"" /»«/a» 
Xp»Linux«/p» 
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</div> 
</div> 


<div class="row mt centered"> 
<div class="col-1g-4"> 
<a class-"zoom green" th:href-"QG(/articleDetailDemo]"»«img 
Cclass-"img-responsive" th:src-"G(/img/portfolio/port04.jpg)" alt="" /»«/a» 
<p> 微 服务 </p> 
</div> 
<div class="col-1g-4"> 
<a class="zoom green" th:href="@{/articleDetailDemo}"><img 
class="img-responsive" th:src="@{/img/portfolio/port05.jpg}" alt="" /></a> 
<p> 多 线程 </p> 
</div> 
<div class="col-1g-4"> 
<a class="zoom green" th:href="@{/articleDetailDemo}"><img 
class="img-responsive" th:src="@{/img/portfolio/port06.jpg}" alt="" /></a> 


<p> 消 息 队 列 </p> 
</div> 
</div> 
</div> 

<div th:include="common/common footer :: commonFooter"></div> 

</body> 

<div th:include="common/common onload js :: onLoadJs"></div> 
</html> 
其 他 页 面 的 制作 原理 类 似 ， 这 里 就 不 多 说 了 。 如 果 读 者 感 兴趣 ， 可 以 自己 尝试 制作 ， 也 可 以 

在 笔者 提供 的 源 代码 的 基础 上 开发 。 


关于 跳 转 都 是 使 用 Controller, 目前 的 数据 都 是 静态 数据 ,比如 首页 的 跳 转 如 代码 清单 13-6 所 示 。 


代码 清单 13-6 ”博客 实战 项 目 -IndexController NA 


GController 
public class IndexController { 


GGetMapping(value = ("/","index"]) 


public String index()( 
return "index"; 
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13.3 效果 展示 


截至 目前 ， 已 经 完成 了 Thymeleaf 模板 项 目的 制作 。 接 下 来 我 们 来 看 页 面 效果 。 
首页 如 图 13-2 所 示 。 


图 13-2 首页 展示 图 
博客 页 如 图 13-3 所 示 。 


^ 


e 


e 


133 ”博客 页 展示 图 


搜索 页 如 图 13-4 所 示 。 
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关于 网 站 


Copyright © 2018. Dalacyangcn 


Al rights reserved. 
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图 134 搜索 页 展示 图 
关于 页 如 图 13-5 所 示 。 


DALAOYANG 


dum 
About DALAOYANG! 


53, SüESpringBoot2 A2 IAE M, KARIA, WN, 


关于 网 站 


ight © 2018 Dalaoyangcn 


Ali rights reserved, 


014944 号 -1 


图 13-5 关于 页 展示 图 
联系 页 如 图 13-6 所 示 。 
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DALAOYANG 


联系 我 


欢 这 有 时 与 我 交流 ， 发 一 封 邮件 给 我 


关于 网 站 


Copyright © 2018. Dalaoyangcn 


13-6 联系 页 展示 图 
标签 页 如 图 13-7 所 示 。 


DALAOYANG 


标签 列表 

SpringBoot SpringCloud Nginx Linux Mybatis Spring Data Jps JDBC Eureka SpringBoot 
SpringCloud Nginx Linux Mybatis Spring Data Jpa JDBC Eureka SpringBoot SpringCloud 
Nginx Linux Mybatis Spring Data Jpa JDBC Eureka SpringBoot SpringCloud Nginx Linux 
Mybatis Spring Data Jpa JDBC Eureka 


关于 网 站 


Copyright © 2018. Dalaoyang.cn 


Ali rights reserved. 


辽 ICP 备 17019. 


13-7 标签 页 展示 图 
标签 对 应 博客 页 内 容 与 博客 列表 页 一 致 ， 这 里 就 不 展示 了 。 文 章 详情 页 如 图 13-8 所 示 。 
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图 13-8 文章 详情 页 展示 图 


13.4 依赖 配置 


正如 前 面 介绍 的 ， 本 文 使 用 的 前 端 模板 框架 是 Thymeleaf， 数 据 库 为 MySQL 数据 库 。 因 为 只 
有 一 些 简 单 的 查询 ， 所 以 ORM 层 使 用 Spring Data JPA， 并 且 加 入 了 pegdown 依赖 支持 Markdown 
格式 文章 转换 ， 依 赖 内 容 如 代码 清单 13-7 所 示 。 


代码 清单 13-7 ”博客 项 目 -依赖 配置 


<dependencies> 
I MJpogos 
<dependency> 
<groupId>org.springframework.boot</groupId> 
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<artifactId>spring-boot-starter-data-jpa</artifactId> 
</dependency> 

<!-- thymeleaf--> 

<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-thymeleaf</artifactId> 

</dependency> 

<l-- web--> 

<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 

</dependency> 

<l-- mysql--> 

<dependency> 
<groupId>mysql</groupId> 
<artifactId>mysql-connector-java</artifactId> 
<scope>runtime</scope> 

</dependency> 

<!-- 去 除 thymeleaf 严格 校 验 --> 

<dependency> 
<groupId>net .sourceforge.nekohtml</groupId> 
X«artifactId»nekohtml«/artifactId» 
«version»1.9.22«/version» 

</dependency> 

«!-- lombok--» 

«dependency» 
XgroupId»org.projectlombok«/groupId» 
«artifactId»lombok«/artifactId» 
«version»1.16.20«/version» 

</dependency> 

<!-- 转换 markdown--> 

<dependency> 
<groupId>org.pegdown</groupId> 
<artifactId>pegdown</artifactId> 
<version>1.6.0</version> 

</dependency> 


</dependencies> 


13.5 配置 文件 


配置 文件 配置 类 Thymeleaf 的 缓存 设置 ， 这 里 暂时 设置 为 false， 当 全 部 开发 完成 后 ， 可 以 设 
置 为 tue， 剩 余 只 配置 了 数据 库 和 JPA， 端 口号 设置 的 是 10000。 完 整 配 置 如 代码 清单 13-8 所 示 。 


330 | Spring Boot 2 实战 之 旅 


代码 清单 13-8 博客 项 目 -配置 文件 内 容 


## 端 口号 

server.port=10000 

## 禁 用 thymeleaf 缓存 
spring.thymeleaf.cache-false 


## 数 据 库 配 置 

## 数 据 库 地 址 

spring.datasource.url-jdbc:mysql://localhost:3306/springbootBlog?characte 
rEncoding-utf8&useSSL-false 

## 数 据 库 用 户 名 

spring.datasource.username=root 

## 数 据 库 密码 

spring.datasource.password-root 

## 数 据 库 驱 动 


spring.datasource.driver-class-name-com.mysql.jdbc.Driver 


##none ”启动 时 不 做 任何 操作 
spring.jpa.hibernate.ddl-auto-update 
## 控 制 台 打 印 sql 


spring.jpa.show-sgl-true 
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接 下 来 介绍 博客 需要 的 几 张 表 ， 由 于 使 用 JPA 进行 操作 ， 因 此 创建 了 对 应 的 实体 类 ， 可 以 在 
数据 库 中 生成 对 应 的 表 。 


13.6.1 XER 


文章 表 主 要 记录 文章 信息 ， 是 博客 最 主要 的 表 ， 表 名 为 article， 针 对 当前 案例 设置 了 以 下 几 个 
字段 属性 。 
aricleld: 文章 主键 ID， 设 置 主键 自 增 列 。 
articleName: 文章 名 称 。 
articleContent: 文章 内 容 ， 设 置 字段 类 型 为 TEXT。 
articleAuthors: 文章 作者 。 
articleInputDate: 文章 录入 日 期 设置 字段 类 型 为 Date. 
articleReadingTime: 文章 阅读 次 数 。 
isTop: 是 否 置顶 。 
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© isEnable: 是 否 启 用 (可 以 理解 为 是 否 发 布 )。 

€ tagList: 设置 与 标签 表 的 多 对 多 关系 。 

接 下 来 介绍 的 几 个 属性 是 在 项 目 内 使 用 的 ， 并 非 数据 库 字 段 。 

o imageNo: 文章 对 应 图 片 ， 案 例 中 只 在 首页 置顶 文章 中 设置 了 对 应 的 图 片 。 

* arüclelntroduction: 文章 简介 ， 用 于 文章 列表 页 、 搜 索 页 、 标 签 文章 页 展示 文章 简介 ， 案例 中 
是 将 文章 内 容 去 除 HTML 标签 内 容 后 ， 截 取 100 个 字符 组 成 。 

* articleShowContent: 展示 文章 内 容 ， 因 为 支持 Markdown 语法 ， 所 以 需要 将 Markdown 格式 
文章 内 容 直接 存储 到 数据 库 中 ， 案 例 中 使 用 这 个 字段 展示 文章 详细 内 容 。 


完整 article 实体 类 内 容 如 代码 清单 13-9 所 示 。 


@Entity 

@Table (name = "article") 
@Data 
@AllArgsConstructor 


@NoArgsConstructor 


Public class Article implements Serializable { 


private static final long serialVersionUID = 4967006908141911451L; 
@Id 

@GeneratedValue (strategy = GenerationType.IDENTITY) 
private Long articleId; 

private String articleName; 

GLob 

GColumn(columnDefinition = "TEXT") 

private String articleContent; 

private String articleAuthors; 
GTemporal(TemporalType.DATE) 

private Date articleInputDate; 

private Integer articleReadingTime; 

private Integer isTop; 

private Integer isEnable; 


GManyToMany 

GJoinTable (name = "articleTag", joinColumns = (8JoinColumn (name = 
"articleId")), inverseJoinColumns = (G8JoinColumn (name = "tagId")]) 

private List«Tag» tagList; 


// 项 目 内 使 用 ， 非 数据 库 字 段 
GTransient 


private int imageNo; 
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QTransient 
private String articleIntroduction; 


GTransient 
private String articleShowContent; 


13.6.2 ”标签 表 


代 


标签 表 主 要 记录 标签 信息 ， 表 名 为 ttg， 针 对 当前 案例 设置 如 下 字段 。 
tagId: 标签 表 主 键 ID， 设 置 主键 自 增 列 。 

tagName: 标签 名 称 。 

tagInputDate: 标签 录入 日 期 设置 字段 类 型 为 Date。 
articleList: 设置 与 文章 表 的 多 对 多 关系 。 


完整 tag 实体 类 内 容 如 代码 清单 13-10 所 示 。 


清单 13-10 ”博客 项 目 -tag 实体 类 内 容 


GEntity 

@Table (name = "tag") 

GData 

QGAllArgsConstructor 

GNoArgsConstructor 

public class Tag implements Serializable ( 


private static final long serialVersionUID = -7536613142331362542L1; 
@Id 

@GeneratedValue (strategy = GenerationType.IDENTITY) 

Private Long tagId; 

Private String tagName; 

@Temporal (TemporalType.DATE) 

Private Date tagInputDate; 


@ManyToMany 
@JoinTable (name = "articleTag", joinColumns = {@JoinColumn (name = 


"tagId")), inverseJoinColumns = {@JoinColumn (name = "articleId")]) 


Private List<Article> articleList; 
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13.6.3 ”链接 表 


链接 表 其 实 可 以 理解 为 博客 内 友情 链接 存储 的 数据 表 ， 表 名 为 link， 针 对 当前 案例 设置 如 下 
字段 。 
linkId: 链接 表 主键 ID， 设置 主键 自 增 列 。 
linkName: 友情 链接 名 称 。 
linkUrl: 友情 链接 地 址 。 
remark: 友情 链接 备注 。 


完整 link 实体 类 内 容 如 代码 清单 13-11 所 示 。 


代码 清单 13-11 博客 项 目 -link 实体 类 内 容 


GEntity 
GTable(name = "link") 
GData 
QGAllArgsConstructor 
GNoArgsConstructor 
public class Link implements Serializable ( 
private static final long serialVersionUID = -47259375501975996171; 
@Id 
QGeneratedValue (strategy = GenerationType.IDENTITY) 
Private Long linkId; 
private String linkName; 
private String linkUrl; 
private String remark; 


13.6.4 KAR 


消息 表 主 要 用 于 记录 访客 在 联系 页 给 博 主 留 言 的 信息 ， 表 名 为 message， 针 对 当前 案例 设置 如 
下 字段 。 
messageld: 消息 表 主键 ID， 设置 主键 自 增 列 。 
email: 发 消息 人 的 邮箱 地 址 。 
name: 发 消息 人 的 名 称 。 
subject: 消息 的 主题 。 
messageContent: 消息 的 内 容 ， 设 置 字段 类 型 为 TEXT。 
messageInputDate: 消息 发 送 的 时 间 。 
isRead: 是 否 已 读 。 
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完整 message 实体 类 内 容 如 代码 清单 13-12 所 示 。 


代码 清单 13-12 博客 项 目 -message 实体 类 内 容 


@Entity 
QTable (name = "message") 
@Data 
@AllArgsConstructor 
GNoArgsConstructor 
public class Message implements Serializable ( 
private static final long serialVersionUID = -5529232129767452275L1; 
Gerd 
GGeneratedValue (strategy = GenerationType.IDENTITY) 
private Long messageId; 
private String email; 
private String name; 
private String subject; 
GLob 
GColumn (columnDefinition-"TEXT") 
private String messageContent; 
private Date messageInputDate; 
private Integer isRead; 


13.6.5 ”博客 访问 记录 表 


博客 访问 记录 表 主 要 用 于 记录 以 日 为 单位 博客 的 访问 次 数 ， 表 名 为 website_access， 针 对 当前 
案例 设置 如 下 字段 。 
id: 博客 访问 记录 表 主 键 ID， 设 置 主键 自 增 列 。 
* accessDate: 访问 记录 的 日 期 设置 字段 类 型 为 Date。 
* accessCount: 访问 的 次 数 。 


完整 WebsiteAccess 实体 类 内 容 如 代码 清单 13-13 所 示 。 


单 13-13 ”博客 项 目 -WebsiteAccess 实体 类 内 容 


@Entity 

@Table (name = "websiteAccess") 

@Data 

@AllArgsConstructor 

@NoArgsConstructor 

public class WebsiteAccess implements Serializable { 
private static final long serialVersionUID = 6948407037095536818L; 
era 
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GGeneratedValue (strategy = GenerationType.IDENTITY) 
private Long id; 

G Temporal (TemporalType.DATE) 

private Date accessDate; 

private Integer accessCount; 


13.6.06 ”博客 配置 表 


博客 配置 表 主 要 用 于 记录 一 些 博客 的 配置 信息 ， 表 名 为 website_config， 针 对 当前 案例 设置 了 
如 下 字段 。 
ld: 博客 配置 表 主键 ID， 设 置 主键 自 增 列 。 
blogName: 博客 名 称 。 
authorName: 博 主 名 称 。 
aboutPageArticleld: 介绍 博 主页 面 的 文章 ID. 
recordNumber: 备案 号 。 
domainName: 域名 。 
emailUsername: 博 主 邮箱 地 址 。 


完整 WebsiteConfig 实体 类 内 容 如 代码 清单 13-14 所 示 。 


代码 清单 13-14 ”博客 项 目 -WebsiteConfig 实体 类 内 容 


@Entity 
@Table (name = "websiteConfig") 
GData 
GAllArgsConstructor 
GNoArgsConstructor 
public class WebsiteConfig implements Serializable ( 
private static final long serialVersionUID = 7023358255818152969L1; 
eid 
private Long Id; 
private String blogName; 
private String authorName; 
private Long aboutPageArticleId; 
private String recordNumber; 
private String domainName; 
private String emailUsername; 
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13.7 x EX 能 


首先 来 看 本 案例 应 用 程序 的 目录 结构 ， 如 图 13-9 所 示 。 
其 中 ， 每 个 包 对 应 的 功能 如 下 。 


* config; 配置 案例 中 用 于 配置 拦截 器 。 

* constants: 常量 ， 案 例 中 常量 类 所 在 包 。 

* controller: 控制 层 ， 案 例 中 控制 层 大 多 只 用 于 封装 
数据 和 页 面 跳 转 。 

o entity: 实体 ， 在 13.6 节 已 经 介绍 了 。 
init: 初始 化 ， 用 于 初始 化 应 用 中 的 数据 。 
interceptors: 拦截 器 , 案例 中 用 于 更 新 博客 访问 次 数 
和 初始 化 底部 数据 。 

* repository: 数据 操作 层 ， 用 于 JPA 操作 数据 库 。 

* service: 业务 层 ， 案 例 中 用 于 调用 数据 操作 层 和 一 
些 业务 逻辑 处 理 。 

* timer: 定时 器 ,案例 中 的 定时 器 主要 用 于 在 每 日 凌 
展 创建 博客 访问 数据 表 记 录 。 

* util; 工具 ， 案 例 中 包含 两 个 工具 类 : Markdown $ um 
换 工 具 类 和 去 除 HTML 标签 工具 类 。 图 13-9 项 目 目标 结构 图 


m 


头 部 内 容 是 写 死 的 。 当 然 ， 读 者 也 可 以 在 配置 类 中 配置 ， 然 后 动态 泻 染 ， 底 部 稍 后 会 介绍 。 
这 里 以 博客 页 、 搜 索 页 、 文 章 详情 页 和 联系 页 为 例 介绍 博客 主流 程 的 代码 编写 。 


13.7.1 博客 页 


博客 页 中 间 部 分 是 由 10 条 已 发 布 的 文章 数据 组 成 的 ， 带 有 分 页 ， 并 且 根 据 articleld 进行 倒叙 
排序 ， 所 以 我 们 需要 从 数据 库 查 询 数据 展示 页 面 。 由 于 使 用 了 分 页 并 且 需 要 查询 已 经 发 布 的 文章 ， 
因此 需要 传 入 Pageable 分 页 对 象 和 isEnable 是 否 发 布 标 示 。Repository 层 的 方法 如 代码 清单 13-15 
所 示 。 


代码 清单 13-15 ”博客 项 目 -博客 页 数据 操作 层 内 容 


Page<Article> findAllByIsEnable (Integer isEnable, Pageable pageable); 


在 Service 层 构建 分 页 所 需 的 Pageable， 然 后 调用 Repository 层 的 方法 ， 并 且 在 方法 上 加 入 
@Cacheable 注解 使 用 缓存 。Service 层 内 容 如 代码 清单 13-16 所 示 。 
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代码 清单 13-16 博客 项 目 -博客 页 Service 层 内 容 


GOverride 

GCacheable(value = "blogArticle", key = "£page") 

public Page«Article» findBlogArticleList(int page, int size) ( 
Pageable pageable = PageRequest.of(page, size, Sort.Direction.DESC, 


"articleId"); 
return articleRepository.findAllByIsEnable(Constants.YES, pageable); 


博客 页 Controller 层 包含 两 个 方法 ， 映 射 路 径 分 别 是 /blog 和 /blog/{fpageNumber}， 后 者 使 用 路 
径 中 的 pageNumber 作为 页 码 进行 分 页 查询 , 然后 将 查询 到 的 数据 进行 循环 遍历 ,文章 详情 去 HTML 
标签 设置 到 articleIntroduction 属性 中 。 完 整 BlogController 内 容 如 代码 清单 13-17 所 示 。 


青 单 13-17 ”博客 项 目 -博客 页 Controller 层 


A 


GController 
public class BlogController { 
GAutowired 
private ArticleService articleService; 


GGetMapping("/blog") 
public String blog(Model model) ( 
return this.blog(model, 1); 
3 
GGetMapping("/blog/(pageNumber)") 
public String blog(Model model, GPathVariable Integer pageNumber) ( 
if (pageNumber -- null) ( 
pageNumber - 1; 


) 
Page«Article» articlePage = articleService.findBlogArticleList 


((pageNumber-1)*Constants.defaultPageSize,Constants.defaultPageSize ); 
List«Article» articleList = articlePage.getContent(); 
articleList.forEach(article -> ( 

String articleIntroduction - HtmlSpirit.delHTMLTag 

(article.getArticleContent ()); 

article.setArticleIntroduction(articleIntroduction.length() > 

100 ? articleIntroduction.substring(0, 100) : articleIntroduction); 

Da 

model.addAttribute("articleList", articleList); 
model.addAttribute("totalCount", articlePage.getTotalElements()); 
model.addAttribute ("pageNumber", pageNumber); 


return "blog"; 
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最 后 查看 页 面 展示 ， 使 用 theach 进行 迭代 集合 ， 使 用 th:text 进行 集合 内 对 象 内 容 的 展示 。 这 
里 的 内 容 很 简单 ， 就 不 做 太 多 介绍 了 。 完 整 内 容 如 代码 清单 13-18 所 示 。 


青 单 13-18 ”博客 项 目 -博客 页 前 端 页 面 内 容 


<html xmlns-"http://www.w3.0rg/1999/xhtml" 
xmlns:the"http://www.thymeleaf.org"» 

<html lang-"en"» 

Xhead th:include-"common/common head::commonHeader"»«/head» 

<body> 

<div th:include="common/common navigation :: commonNavigation"></div> 


<div> 
<p> </p> 
<div th:each="al,iterStat : ${articleList}"> 
<div class="container"> 
<div class="row"> 
<div class-"col-lg-8 col-lg-offset-2"> 
<p><img th:src="@{/img/user.png}" width="50px" 
height="50px"> «span th:text="${al.articleAuthors}"></span></p> 
<p th:text="${al.articleInputDate}"></p> 
<h4 th:text="${al.articleName}"></h4> 
<p th:text="${al.articleIntroduction}"></p> 
<p><a th:href="${'/article/'+al.articleId}"> 查 看 详情 ... 
</a></p> 
</div> 
</div> 
</div> 
</div> 


<div style-"margin-bottom: 50px;"» 
<div class-"col-md-3" »«/div» 
<div class-"col-md-6"»«ul class-"page" maxshowpageitem-"5" 
pagelistcount-"10" id-"page"»«/ul»«/div» 
<div class-"col-md-3"»«/div» 
«/div» 
«/div» 
<div th:include-"common/common footer :: commonFooter"»«/div» 
</body> 
<div th:include="common/common_onload_js :: onLoadJs"></div> 
<script type="text/javascript" th:inline="javascript"> 
[[${totalCount}]]; 
var pageNumber = [[${pageNumber}]]; 
var urlPre = "blog/"; 
var GG = { 
"kk" :function (mm) { 


var totalCount 
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if (mm==1) { 

window.location.href = getRootPath dc ()+urlPre; 
}else{ 

window.location.href- getRootPath dc()-*urlPre*mm; 


5 
$("fpage") .initPage (totalCount,pageNumber,GG.kk) ; 
function getRootPath dc() ( 


return window.location.protocol + '//' + window.location.host*"/"; 


j 


</script> 
</html> 


13.7.2 ”搜索 页 


搜索 页 大 致 内 容 与 博客 页 相似 ， 不 过 这 里 使 用 了 复杂 查询 ， 所 以 需要 特别 提 一 下 。 首 先 需 要 
在 Repository 层 继承 JpaRepository 和 JpaSpecificationExecutor， 如 代码 清单 13-19 所 示 。 


代码 清单 13-19 博客 项 目 -搜索 页 数据 操作 层 内 容 


public interface ArticleRepository extends JpaRepository«Article, Long», 
JpaSpecificationExecutor«Article» ( 
} 


在 Service 层 调用 JpaSpecificationExecutor 类 中 的 findAll 方法 ， 这 里 需要 传 入 Specification 对 
RAI Pageable 对 象 。 其 中 ，Pageable 对 象 是 分 页 对 象 ， 大 家 都 很 了 解 了 ; Specification 对 象 用 于 构 
建 查询 条 件 。 

比如 ， 文 章 要 构建 的 语句 如 代码 清单 13-20 所 示 。 


代码 清单 13-20 博客 项 目 -搜索 页 查询 SQL 


SELECT 
article id, 
article authors, 
article content, 
article input date, 
article name, 
article reading time, 
is enable, 
is top 

FROM 
article 
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WHERE 
( article name LIKE '% 第 六 %$' OR article content LIKE '$5875$' ) 
AND is enable - 1 
ORDER BY 
article id DESC 
LIMIT 10 


这 里 创建 一 个 getWhereClause 方法 用 于 构建 查询 条 件 , 构建 结果 与 上 面 SQL 代码 中 Where 后 
的 语 名 一样， 如 代码 清单 13-21 所 示 。 


博客 项 目 -搜索 页 构建 查询 条 件 内 容 


private Specification«Article» getWhereClause(String keyword) ( 
return new Specification«Article»() ( 
GOverride 
public Predicate toPredicate (Root«Article» root, CriteriaQuery«?» query, 
CriteriaBuilder cb) ( 
List«Predicate» predicate = new ArrayList«»(); 
if (StringUtils.isNotBlank(keyword)) ( 
predicate.add( 
cb.and( 
cb.or( 
cb.like(root.get("articleName"), "$" + keyword + "$"), 
cb.like(root.get("articleContent"), "$" + keyword + "$") 


predicate.add(cb.equal(root.get("isEnable"), Constants.YES)); 
Predicate[] pre - new Predicate[predicate.size()]; 
return query.where (predicate.toArray (pre)).getRestriction(); 


对 应 Service 层 调用 如 代码 清单 13-22 所 示 。 
青 单 13-22 ”博客 项 目 -搜索 页 


代 rice 层 内 容 


GOverride 
public Page«Article» findSearchArticleList(int page, int size, String 
keyword) ( 
Pageable pageable = PageRequest.of(page, size, Sort.Direction.DESC, 
"articleId"); 
return articleRepository.findAll(this.getWhereClause (keyword), 
pageable); 
b 
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控制 层 及 页 面 泻 染 数据 与 博客 列表 页 类 似 ， 这 里 不 再 更 述 。 


13.7.3 “文章 详情 页 


文章 详情 页 其 实 就 是 根据 文章 ID 查询 文章 详情 ， 在 Repository 层 传 入 articleld 和 isEnable， 
如 代码 清单 13-23 所 示 。 


代码 清单 13-23 ”博客 项 目 -文章 详情 页 数据 操作 层 内 容 


Article findByIsEnableAndArticleId(Integer isEnable,Long articleId); 


Service 层 没有 特别 的 东西 ， 就 是 调用 Repository 层 ， 如 代码 清单 13-24 所 示 。 


代码 清单 13-24 博客 项 目 -文章 详情 页 Service 层 内 容 


GOverride 
public Article findIsEnableArticleByArticleId(Long articleId) ( 
return articleRepository.findByIsEnableAndArticleId (Constants.YES, 


articleId); 
} 
Controller 层 除 了 调用 Service 层 查询 数据 之 外 , 还 需要 更 新 文章 阅读 次 数 和 使 用 Markdown 转 
换 工 具 将 articleContent 转换 为 可 展示 类 型 。 完 整 ArticleController 内 容 如 代码 清单 13-25 所 示 。 


代码 清单 13-25 ”博客 项 目 -文章 详情 页 Controller 层 内 容 


GController 
public class ArticleController ( 


GAutowired 
private ArticleService articleService; 


GGetMapping("/article/(id)") 

public String viewArticle(Model model, GPathVariable Long id) ( 
Article article - articleService.findIsEnableArticleByArticleId(id); 
article.setArticleReadingTime (article.getArticleReadingTime() + 1); 
articleService.saveArticle (article); 
article.setArticleShowContent (MarkdownToHtml.markDownToHtml 

(article.getArticleContent ())); 

model.addAttribute("article", article); 
return "article"; 


J 


页 面 展示 演 染 数据 都 是 使 用 Thymeleaf 语言 进行 展示 的 ， 如 代码 清单 13-26 所 示 。 
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青 单 13-26 ”博客 项 目 -文章 详情 页 


<html xmlns-"http://www.w3.0rg/1999/xhtml" 
xmlns:th-"http://www.thymeleaf.org"» 
<html lang-"en"» 


<head th:include-"common/common head::commonHeader"»«/head» 


<body> 


<div th:include-"common/common navigation :: commonNavigation"></div> 
<div id="white"> 
<div class="container"> 
<div class="row"> 
<div class-"col-lg-8 col-lg-offset-2"> 
<p><img th:src 


"@{/img/user.png}" width="50px" 
height="50px"> <span th:text="${article.articleAuthors}"></span> </p> 
«p» 
<i class="fa fa-clock-o"»«/i»«a th:text- 
"$(article.articleInputDate)"»5«/a» 
<i class="fa fa-eye"»«/i»«a th:text- 
"$(article.articleReadingTime)"»«/a» 
</p> 
<h4 th:text="${article.articleName}"></h4> 
<div th:utext="${article.articleShowContent}" style= 
"overflow:hidden" > </div> 
<p> 标 签 : 
<span th:each-"al,iterStat : ${article.tagList}"> 
<i class="fa fa-tag"></i><a target=" blank" th:href= 
"${'/tag/'+al.tagName}" th:text="${al.tagName}"></a> 
</span> 
</p> 
<hr> 
<p><a th:href="@{/blog}"># 返回 博客 列表 </a></p> 
</div> 


</div> 
</div> 
</div> 
<div th:include="common/common footer :: commonFooter"></div> 


</body> 
<div th:include-"common/common onload js :: onLoadJs"></div> 


</html> 
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13.74 联系 页 


联系 页 的 后 台 内 容 比 较 简 单 ， 后 台 使 用 Message 对 象 接收 前 台 传 送 的 数据 ， 并 且 在 保存 方法 
上 加 入 了 事务 注解 @Transactional。ContactController 类 完整 内 容 如 代码 清单 13-27 所 示 。 


青 单 13-27 ”博客 项 目 -联系 页 Controller BAF 


GController 
public class ContactController ( 


GGetMapping("/contact") 
public String contact() ( 
return "contact"; 


5 


GAutowired 
private MessageService messageService; 


GPostMapping ("/contact/sendMail") 

GResponseBody 

GTransactional(rollbackFor = Throwable.class) 

public String sendMail(G8RequestBody Message message) ( 
message.setMessageInputDate (new Date()); 
messageService.saveMessage (message) ; 
return "success"; 


) 


Service 层 和 Repository 层 只 是 简单 地 调用 和 保存 ， 这 里 不 再 袭 述 。 接 下 来 介绍 前 端 发 起 Ajax 
请 求 ， 如 代码 清单 13-28 所 示 。 


代码 清单 13-28 ”博客 项 目 -联系 页 


$("button").click(function() ( 
if(!$('#contact form').valid())( 
return false; 


var url = getRootPath dc() + "contact/sendMail"; 
var name = $('f&name').val(); 
var email = $('f&email').val(); 
var subject = $('£subject').val(); 
var messageContent = $('&messageContent').val(); 
$.ajax(t 

type : "POST", 

GEE rS 
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contentType: "application/json;charset-UTF-8", 
data : JSON.stringify(( 


"name": name, 
"email": email, 
"subject": subject, 
"messageContent": messageContent 
n, 
success : function(result) ( 


if (result == 'success')( 
alert ("提交 成 功 ! "); 
Jelse( 


alert ("留言 失败 ， 请 联系 博客 管理 员 。") ; 


Wa 
Da 
主要 功能 大 致 介绍 到 这 里 。 其 他 类 似 功能 相信 读者 经 过 阅读 源 代 码 可 以 直接 看 懂 ， 这 里 暂且 
略 过 。 


13.8 辅助 功能 


本 案例 中 的 辅助 功能 其 实 并 不 是 很 多 ， 有 拦截 器 、 定 时 器 和 初始 化 数据 方法 。 接 下 来 分 别 进 
行 介绍 。 


13.81 拦截 器 


案例 中 拦截 器 的 主要 作用 是 加 载 底部 数据 和 更 新 网 站 访问 次 数 ， 完 整 内 容 如 代码 清单 13-29 
所 示 。 


代码 清单 13-29 博客 项 目 -拦截 器 内 容 


GComponent 
public class RequestInterceptor extends HandlerInterceptorAdapter { 
Logger logger - LoggerFactory.getLogger (RequestInterceptor.class); 
GAutowired 
private WebsiteAccessService websiteAccessService; 
GAutowired 
private TagService tagService; 
GAutowired 
private LinkService linkService; 
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GAutowired 
private WebsiteConfigService websiteConfigService; 


GOverride 


public void postHandle(HttpServletRequest request, HttpServletResponse 
response, Object handler, ModelAndView modelAndView) throws Exception ( 
if(modelAndView !- null)( 

ModelMap modelMap = modelAndView.getModelMap(); 

logger.info(" 正 在 更 新 网 站 访问 次 数 。") ; 

WebsiteAccess websiteAccess = websiteAccessService. 
getByAccessDateIs (new Date()); 

websiteAccess.setAccessCount (websiteAccess.getAccessCount () +1); 


websiteAccessService.save (websiteAccess); 


logger.info (" 加 入 底部 数据 。") ; 


// 标 签 列表 

modelMap.addAttribute("tagList", tagService.findAll()); 

// 友 情 链 接 列表 

modelMap.addAttribute ("linkList",linkService.findAllByIsEnable ()); 
// 友 情 链 接 列表 


modelMap.addAttribute("websiteConfig", websiteConfigService. 
findWebsiteConfig()); 
) 


13.8.2 ”定时 器 


案例 中 定时 器 使 用 Spring 定时 任务 ， 主 要 用 于 在 设 定时 间 插入 每 日 访问 统计 的 记录 ， 完 整 内 
容 如 代码 清单 13-30 所 示 。 


代码 清单 13-30 ”博客 项 目 -定时 器 内 容 


GComponent 
public class WebSiteTimer ( 
GAutowired 
private WebsiteAccessService websiteAccessService; 
GScheduled(cron = "0 0 0 1/1 * ?") 
private void updateTodayWebsiteVisits() ( 
WebsiteAccess websiteAccess - new WebsiteAccess(); 


websiteAccess.setAccessCount (1); 
websiteAccess.setAccessDate (new Date()); 
websiteAccessService.save (websiteAccess); 
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13.8.3 ”初始 化 


这 个 方法 只 是 在 没有 数据 测试 的 时 候 报 错 才 添加 的 ， 是 在 拦截 器 更 新 网 站 访问 次 数 的 时 候 ， 
website access 表 内 没有 数据 引起 的 。 所 以 这 里 设置 了 一 个 方法 ， 查 询 当天 是 否 存在 website_access 
表 的 数据 ， 如 果 不 存在 ， 就 插入 一 条 。 博客 配置 表 也 存在 同样 的 问题 ， 不 存在 数据 的 话 ， 需 要 插入 
一 条 默认 数据 来 避免 这 个 问题 。 当 然 , 读者 也 可 以 选择 别 的 方式 处 理 这 个 问题 。 完整 内 容 如 代码 清 
单 13-31 所 示 。 


代码 清单 13-31 博客 项 目 -初始 化 数据 


GComponent 
public class InitWebsiteData { 
GAutowired 
private WebsiteAccessService websiteAccessService; 


GAutowired 
private WebsiteConfigService websiteConfigService; 


GPostConstruct 
public void initWebsiteVisits()í 

// 查 询 当日 是 否 存在 博客 访问 表 记 录 ， 若 不 存在 ， 则 插入 

if(websiteAccessService.getByAccessDateIs (new Date()) == null)( 
WebsiteAccess websiteAccess - new WebsiteAccess(); 
websiteAccess.setAccessCount (1); 
websiteAccess.setAccessDate (new Date()); 
websiteAccessService.save (websiteAccess); 

H 

// 查 询 当 日 是 否 存在 博客 配置 表 记 录 ， 若 不 存在 ， 则 插入 

if(websiteConfigService.findWebsiteConfig()--null)( 
WebsiteConfig websiteConfig - new WebsiteConfig(); 
websiteConfig.setId(1L); 
websiteConfig.setAboutPageArticleId (7L); 
websiteConfig.setBlogName ("SpringBoot 博客 ") ; 
websiteConfig.setAuthorName ("dalaoyang"); 
websiteConfig.setDomainName ("Dalaoyang.cn"); 
websiteConfig.setRecordNumber ("X ICP & 17014944 号 -1") ; 
websiteConfig.setEmailUsername ("dalaoyang8aliyun.com"); 
websiteConfigService.saveWebsiteConfig (websiteConfig); 


) 


辅助 功能 到 这 里 就 大 致 结束 了 。 其 实 博客 还 有 很 多 地 方 可 以 扩展 ， 读 者 可 以 自由 发 挥 。 
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13.9 小 结 


本 章 介 绍 了 如 何 使 用 之 前 学 习 的 内 容 构 建 一 个 博客 系统 ， 建 议 读者 在 笔者 制作 的 Thymeleaf 
模板 的 基础 上 进行 练习 。 
另外 ， 笔 者 写 了 一 个 SQL 脚本 供 大 家 预 设 数据 进行 测试 ， 如 代码 清单 13-32 所 示 。 


代码 清单 13-32 ”博客 项 目 -初始 化 内 容 SQL 


## init article 

INSERT INTO 'springbootBlog' ."article' (“article id', "article authors', 
"article content", "article input date", "article name', 
"article reading time', "is enable', ^is top") VALUES (1, 'dalaoyang', ' 这 是 第 
一 篇 博客 的 摘要 。 这 是 第 一 篇 博客 的 摘要 。 这 是 第 一 篇 博客 的 摘要 。 这 是 第 一 篇 博客 的 摘要 。 这 是 第 一 篇 
博客 的 摘要 。 这 是 第 一 篇 博客 的 摘要 。 这 是 第 一 篇 博客 的 摘要 。'，'2019-01-01 00:00:00'，' 第 一 
篇 博客 '，1，1，1)， 

INSERT INTO 'springbootBlog' ."article' (“article id', "article _ authors ， 
"article content", "article input date", "article name', 
"article reading time", ^is enable', ^is top") VALUES (2，'dalaoyang'，' 这 是 第 
二 篇 博客 的 摘要 。 这 是 第 二 篇 博客 的 摘要 。 这 是 第 二 篇 博客 的 摘要 。 这 是 第 二 篇 博客 的 摘要 。 这 是 第 二 篇 
博客 的 摘要 。 这 是 第 二 篇 博客 的 摘要 。 这 是 第 二 篇 博客 的 摘要 。'，'2019-01-01 00:00:00'，' 第 二 
篇 博客 '，1，1，1) 7 

INSERT INTO ^springbootBlog' `. "article `(`article id', "article _ authors ， 
"article content", "article input date", 'article name', 
"article reading time", ^is enable', ^is top") VALUES (3, 'dalaoyang', 'ZEB 
三 篇 博客 的 摘要 。 这 是 第 三 篇 博客 的 摘要 。 这 是 第 三 篇 博客 的 摘要 。 这 是 第 三 篇 博客 的 摘要 。 这 是 第 三 篇 
博客 的 摘要 。 这 是 第 三 篇 博客 的 摘要 。 这 是 第 三 篇 博客 的 摘要 。'，'2019-01-01 00:00:00'，' 第 三 
篇 博客 '，1，1，1) 7 

INSERT INTO “springbootBlog'.'article' (“article id', "article authors', 
"article content', "article input date”, "article name', 
"article reading time”, ^is enable', ^is top') VALUES (4, 'dalaoyang', RES 
四 篇 博客 的 摘要 。 这 是 第 四 篇 博客 的 摘要 。 这 是 第 四 篇 博客 的 摘要 。 这 是 第 四 篇 博客 的 摘要 。 这 是 第 四 篇 
博客 的 摘要 。 这 是 第 四 篇 博客 的 摘要 。 这 是 第 四 篇 博客 的 摘要 。'，'2019-01-01 00:00:00'，' 第 四 
iiA, 1, 1, 1); 

INSERT INTO ^springbootBlog' .'article' (article id', "article authors', 
"article content", "article input date”, "article name', 
"article reading time", ^is enable', ^is top") VALUES (5, 'dalaoyang', 'iXÉ 
五 篇 博客 的 摘要 。 这 是 第 五 篇 博客 的 摘要 。 这 是 第 五 篇 博客 的 摘要 。 这 是 第 五 篇 博客 的 摘要 。 这 是 第 五 篇 
博客 的 摘要 。 这 是 第 五 篇 博客 的 摘要 。 这 是 第 五 篇 博客 的 摘要 。'，'2019-01-01 00:00:00'，' 第 五 
篇 博客 '，1，1，1); 
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INSERT INTO ^springbootBlog' .'"article' ("article id`， "article authors v 

“article content", "article input date", "article name", 
“article reading time”, ^is enable", ^is top') VALUES (6, 'dalaoyang', ' 这 是 第 
六 篇 博客 的 摘要 。 这 是 第 六 篇 博客 的 摘要 。 这 是 第 六 篇 博客 的 摘要 。 这 是 第 六 篇 博客 的 摘要 。 这 是 第 六 篇 
博客 的 摘要 。 这 是 第 六 篇 博客 的 摘要 。 这 是 第 六 篇 博客 的 摘要 。' ，'2019-01-01 00:00:00', "第 六 
篇 博客 '，1,，1,，1); 

INSERT INTO 'springbootBlog'.'article' (“article id', "article authors', 
“article content", "article input date', "article name', 

"article reading time”, "is enable', ^is top") VALUES (7, 'dalaoyang', 'XXHf, 
我 是 Spring Boot2 实战 之 旅 的 作者 杨洋 ， 感 谢 大 家 对 我 的 支持 ， 谢 谢 。\n\n'， '2019-02-21', 
'About DALAOYANG!NAnWn', 0, 0, 0); 

## init link 

INSERT INTO 'springbootBlog' ."link' (“link id', “link name', “link url', 
^remark^) VALUES (1, ' 简 书 '， 'https://www.jianshu.com/u/128b6effde53', ' 简 书 地 
By; 

INSERT INTO ^springbootBlog' .^"link' (“link id", ^link name", “link url', 
"remark') VALUES (2, 'DALAOYANG', 'https://www.dalaoyang.cn', 'dalaoyang 的 博客 
D 

## init tag 

INSERT INTO ^springbootBlog'.^tag' ("tag id^, "tag name") VALUES (1, 
'SpringBoot'); 

INSERT INTO ^springbootBlog'.'tag' ("tag id', "tag name") VALUES (2, 
'SpringCloud'); 

INSERT INTO ^springbootBlog'.'tag' ("tag id', "tag name") VALUES (3, 
'Nginx'); 

INSERT INTO ^springbootBlog'.^tag'(^tag id", ‘tag name") VALUES (4, 
*ninux'y; 

INSERT INTO ^springbootBlog' .^tag' (‘tag id", ‘tag name”) VALUES (5, 
'Tomcat'); 

INSERT INTO ^springbootBlog' ."tag'(^tag id", ‘tag name”) VALUES (6, 'Java'); 

## init article tag 

INSERT INTO 'springbootBlog' .'article tag' ("article id', “tag id”) VALUES 
0, 1); 

INSERT INTO ^springbootBlog'.'article tag' ("article id', “tag id”) VALUES 
0, 3); 

INSERT INTO ^springbootBlog' .'article tag' ("article id', “tag id”) VALUES 
(2, 3); 

INSERT INTO ^springbootBlog' .'article tag' ("article id^, “tag id”) VALUES 
(2, 6); 

INSERT INTO ^springbootBlog' .'article tag' ("article id^, “tag id”) VALUES 
(3, 1); 

INSERT INTO ^springbootBlog' ."article tag" ("article id^, “tag id”) VALUES 
(4, 295 
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INSERT INTO ^springbootBlog' ."article tag" ("article id^, “tag id') VALUES 
(5, 1); 

INSERT INTO ^springbootBlog' ."article tag" ("article id', ‘tag id”) VALUES 
(6, 2); 


## maybe error---------- 

##init website config 

INSERT INTO ^springbootBlog' ." website config' (^id', 
“about page article id', "author name", "blog name", "email username', 
“domain name”, “record number") VALUES (1, 7, 'dalaoyang', 'SpringBoot 博客 '， 
'smtp.aliyun.com', 'Dalaoyang.cn'，' 辽 ICP 备 17014944 号 -1'); 

##init website access 

INSERT INTO 'springbootBlog'." website access" (‘id’, ‘access count', 
“access date”) VALUES (1, 0, now()); 


Spring Boot 实战 之 博客 后 台 系 统 


第 13 章 介绍 了 如 何 利用 Spring Boot 制作 博客 , 但 是 只 有 一 个 博客 系统 , 每 次 发 布 文章 时 都 需 
要 手动 向 数据 库 插入 数据 ， 这 样 显然 有 些 麻 烦 。 本 章 将 带领 读者 结合 第 13 章 的 博客 创建 一 个 博客 
后 台 系统 。 


14.1 博客 后 台 的 制作 思 


客 后 台 系 统 用 于 维护 博客 的 一 些 相关 信息 ， 如 文章 的 管理 、 标 签 的 管理 、 友 情 链 接 的 管理 
BA anas 制作 思路 与 制作 博客 系统 一 致 。 我 们 回顾 一 下 制作 思路 : 


CD 静态 模板 项 目 制作 ,将 HTML 静态 项 目 改 为 Thymeleaf 项 目 ， 使 用 Controller 进行 跳 转 。 
(2) 实体 设计 ， 因 为 使 用 的 是 Spring Data JPA， 所 以 实体 设计 决定 着 数据 库 表 的 结构 。 
(3) 后 台 方法 代码 编写 ， 包 含 查询 数据 库 、 封 装 数据 等 。 

(4) 演 染 数据 ， 将 后 台 查 询 出 来 的 数据 动态 泻 染 到 Thymeleaf。 


14.1.1. 博客 后 台布 局 介绍 


案例 博客 布局 分 为 4 部 分 ， 其 中 头 部 、 底 部 和 左 侧 导航 部 分 是 公用 部 分 ， 右 侧 为 根据 左 侧 导 
航 动态 显示 的 内 容 。4 部 分 分 别 说 明 如 下 。 
o KA: 头 部 左 侧 为 博客 后 台 系 统 名 称 , 右 侧 有 3 个 功能 , 铃 销 图 标 显 示 当 日 博客 的 内 容 信 息 ， 
包括 有 几 条 未 读 消息 、 几 篇 新 增 文 章 、 几 个 新 增 标签 ; 邮件 图 标 显示 最 近 有 几 条 未 读 消息 ; 
最 右 侧 为 退出 登录 按钮. 
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e 左 侧 导 航 : 左 侧 导航 分 为 7 个 模块 ， 分 别 是 首页 、 文 章 管理 、 标 签 管理 、 友 情 链接 管理 、 用 
户 管理 、 消 息 管理 、 系 统管 理 。 其 中 ， 文 章 管理 、 标 签 管理 、 友 情 链接 管理 和 用 户 管理 包含 
二 级 菜单 ， 如 图 14-1 所 示 。 


文章 增删 改 查 


链接 管理 | 用 户 管理 | 消息 管理 


配置 基本 信息 
博客 数据 统计 标签 查询 和 删除 


图 14-1 左 侧 导航 结构 图 


o EMAR: 右 侧 显示 模块 对 应 的 内 容 ， 为 各 个 模块 或 功能 显示 的 内 容 ， 稍 后 会 详细 介绍 。 
e 底部: 底部 只 显示 一 些 博客 配置 信息 ， 如 域名 和 备案 号 ， 比 较 简单 。 


14.1.2 ”博客 功能 介绍 


博客 功能 部 分 就 是 图 14-1 中 单 击 导 航 显示 的 对 应 内 容 ， 分 为 以 下 几 个 功能 。 


(1) 首页 : 首页 主要 是 统计 一 些 文章 的 信息 ， 如 文章 数量 统计 、 标 签 数量 统计 、 友 情 链接 数 
量 统计 、 消 息 数量 统计 、 当 日 访问 量 、 本 周 访问 量 、 当 月 访问 量 、 总 访问 量 和 近 10 日 访问 统计 
图 表 。 

(2) 文章 管理 : 文章 管理 分 为 两 个 子 菜 单 : 文章 列表 和 新 增 文章 。 文 章 列 表 页 可 以 查询 文章 、 
预览 文章 〈 需 要 跳 转 到 博客 系统 )， 单 击 “ 修 改 文章 ” 跳 转 到 修改 文章 页 面 ， 可 以 启动 和 禁用 文章 、 
删除 文章 。 新 增 文 章 页 用 于 增添 文章 和 修改 文章 。 

OD 标签 管理 : 标签 管理 中 含有 标签 列表 页 子 菜单 。 标 签 列表 页 可 以 查询 标签 和 删除 标签 。 

(4) 友情 链接 管理 : 友情 链接 管理 包含 友情 链接 列表 和 新 增 友情 链 接 ， 友 情 链 接 列表 页 包含 
查询 友情 链接 、 删 除 友 情 链 接 和 修改 友情 链接 。 新 增 友情 链接 页 用 于 新 增 和 修改 友情 链接 。 

CO 用 户 管理 : 用 户 管理 中 含有 用 户 列表 和 新 增 用户 。 用 户 列 表 页 可 以 查询 用 户 、 修 改 用 户 
和 禁用 用 户 。 新 增 用 户 页 用 于 新 增 和 修改 用 户 。 

(6) 消息 管理 : 消息 管理 用 于 查看 消息 列表 和 查询 某 条 消息 详情 。 

CD 系统 管理 : 系统 管理 用 于 修改 博客 系统 配置 信息 。 
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142 ”博客 后 台 模 板 制作 


博客 后 台 模 板 制作 与 第 13 章 一 致 ， 大 体 思路 就 是 将 一 些 通用 的 配置 和 模块 提取 出 来 ， 这 里 不 
再 次 述 ， 读 者 可 以 根据 第 13 章 的 提取 方法 进行 博客 后 台 模 板 的 制作 。 


14.3 效果 展示 


本 节 来 看 一 下 博客 后 台 的 效果 图 。 
登录 页 如 图 14-2 所 示 。 


143 首页 效果 图 
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文章 列表 页 如 图 14-4 所 示 。 
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144 文章 列表 页 效果 图 
文章 编辑 页 如 图 14-5 所 示 。 
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图 14-5 文章 编辑 页 效果 图 
标签 列表 页 如 图 14-6 所 示 。 
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图 14-6 标签 列表 页 效果 图 
友情 链接 列表 页 如 图 14-7 所 示 。 


Aue 
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14-7 ”友情 链接 列表 页 效果 图 


友情 链接 编辑 页 如 图 14-8 所 示 。 
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图 14-8 ”友情 链接 编辑 页 效果 图 
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用 户 列表 页 如 图 14-9 所 示 。 


用 户 列表 页 


m an Jr n 


14-9. 用 户 列表 页 效果 图 


用 户 编辑 页 如 图 14-10 所 示 。 
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图 14-10 用 户 编辑 页 效果 图 


消息 列表 页 如 图 14-11 所 示 。 
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springoot 博 客 后 各 = $92. 


消息 列表 页 
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14-11 消息 列表 页 效果 图 


系统 配置 页 如 图 14-12 所 示 。 
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图 14-12 系统 配置 页 效果 图 


14.4 ”依赖 配置 


依赖 配置 与 博客 系统 大 臻 相同， 不 过 这 里 加 入 了 spring-boot-starter-mail 依赖 进行 邮件 发 送 、 
spring-boot-starter-security 依赖 进行 登录 和 授权 。 完 整 依赖 内 容 如 代码 清单 14-1 所 示 。 
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青 单 14-1 博客 后 台 项 目 


«dependencies» 

<l== puc 

«dependency» 
XgroupId»org.springframework.boot«/groupId» 
XartifactId»spring-boot-starter-data-jpa«/artifactId» 

</dependency> 

<!-- thymeleaf--> 

<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-thymeleaf</artifactId> 

</dependency> 

<l-- web--» 

<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 

</dependency> 

€l-- mysql--> 

<dependency> 
XgroupId»mysql«/groupId» 
«artifactId»mysql-connector-java«/artifactId» 
X«scope»runtime«/scope» 

«/dependency» 

«1-- 去 除 thymeleaf 严格 校 验 --> 

<dependency> 
XgroupId»net.sourceforge.nekohtml«/groupId» 
X«artifactId»nekohtml«/artifactId» 
«version»1.9.22«/version» 

</dependency> 

«!-- lombok--» 

«dependency» 
XgroupId»org.projectlombok«/groupId» 
X«artifactId»lombok«/artifactlId» 
«version»1.16.20«/version» 

</dependency> 

cc e 

<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-mail</artifactId> 

</dependency> 

<!-- security--» 

«dependency» 
XgroupId»org.springframework.boot«/groupId» 
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<artifactId>spring-boot-starter-Security</artifactId> 
</dependency> 


<!-- commons-lang--» 

<dependency> 
XgroupId»commons-lang«/groupId» 
XartifactId»commons-lang«/artifactId» 
«version»2.6«/version» 

</dependency> 

<!-- commons-collections--> 

<dependency> 
XgroupId»commons-collections«/groupId» 
XartifactId»commons-collections«/artifactId» 
«version»3.2.2«/version» 


</dependency> 
</dependencies> 
14.5 配置 文件 
配置 文件 与 博客 系统 的 配置 大 致 相同 ， 只 不 过 端口 号 使 用 的 是 10001。 这 里 需要 提醒 一 下 ， 


spring.jpa.hibernate.ddl-auto 属性 没有 特殊 需求 的 话 ， 尽 量 设置 为 update 或 者 none， 如 果 设 置 成 
create， 就 会 造成 数据 丢失 ， 并 且 这 里 加 入 了 邮箱 相关 配置 ， 在 后 台 系统 中 设置 了 定时 器 ， 将 每 日 
的 数据 发 送 至 邮箱 内 《邮箱 配置 需要 修改 成 自己 的 邮箱 配置 ) 。 完 整 配置 如 代码 清单 14-2 所 示 。 


代码 清单 14-2 ”博客 后 台 项 目 -依赖 文件 内 容 


## 端 口号 

server.port=10001 

## 禁 用 thymeleaf 缓存 
spring.thymeleaf.cache-false 


## 数 据 库 配置 

## 数 据 库 地 址 

spring.datasource.url=jdbc:mysql://localhost:3306/springbootBlog?characte 
rEncoding-utf8&useSSL-false 

## 数 据 库 用 户 名 

Sspring.datasource.username-root 

## 数 据 库 密码 

spring.datasource.password-root 

## 数 据 库 驱动 


spring.datasource.driver-class-name-com.mysql.jdbc.Driver 
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##none ”启动 时 不 做 任何 操作 
spring.jpa.hibernate.ddl-auto=update 


Hil TED sql 


spring.jpa.show-sql-true 


## 邮 箱 服务 器 smtp 地 址 

spring .mail .host= 邮 箱 服务 器 smtp 地 址 

## 邮 箱 用 户 名 

spring.mail.username= 邮 箱 名 称 

HARD OES: qq 邮箱 应 该 使 用 独立 密码 ， 在 qq 邮箱 设置 中 获取 ) 
spring.mail.password= 邮 箱 密码 

## 编 码 格式 

spring.mail.default-encoding-UTF-8 


146 后 台 实 体 


由 于 后 台 系 统 与 第 13 章 的 博客 系统 共用 一 套 实体 ， 因 此 这 里 不 再 介绍 实体 。 本 节 介 绍 博客 后 
台 系 统 独立 的 表 。 


14.6.1 用 户 表 


用 户 表 用 于 存储 博客 后 台 系 统 的 用 户 信息 ， 表 名 为 user。 针 对 当前 案例 ， 设 置 了 如 下 几 个 字 
BURIE. 
userld: 用 户 表 主键 ID， 设置 了 主键 自 增 列 。 
username: 用 户 名 称 、 登 录 名 。 
password: 用 户 密 码 。 
email: 用 户 邮 箱 。 
isEnable: 是 否 启 用 ，1 为 启用 ，0 为 禁用 。 
roleList: 设置 与 角色 表 的 多 对 多 关系 。 


roleldList 属性 是 项 目 中 使 用 的 ， 但 是 并 非 数 据 库 字段 。 
* roleldLis: 角色 ID 集合 。 


完整 user 实体 类 内 容 如 代码 清单 14-3 所 示 。 


代码 清单 14-3 ”博客 后 台 项 目 -user 实体 内 容 


@Entity 
@Table (name = "user") 
@Data 
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GAllArgsConstructor 
GNoArgsConstructor 


public class User implements Serializable ( 


private static final long serialVersionUID = 3033545151355633270L; 
Gerd 

GGeneratedValue (strategy = GenerationType.IDENTITY) 

private Long userId; 

private String username; 

private String password; 

private String email; 

private Integer isEnable; 


GManyToMany (fetch-FetchType.EAGER) 

@JoinTable (name = "userRole", joinColumns = (G8JoinColumn (name = 
"userId")), inverseJoinColumns = {@JoinColumn (name = "roleId"))]) 

private List«Role» roleList; 


GTransient 
private List«Long» roleIdList; 


public User(Long userId,String username, String password, String email, 
Integer isEnable,List«Role» roleList) ( 

this.userId - userId; 

this.username - username; 

this.password - password; 

this.email - email; 

this.isEnable isEnable; 

this.roleList - roleList; 


1462 AER 


角色 表 用 于 存储 角色 信息 ， 表 名 为 role。 针 对 当前 案例 ， 设 置 了 如 下 几 个 字段 属性 。 


* roel: 角色 表 主键 ID， 设 置 了 主键 自 增 列 。 
* roleName: 角色 名 称 。 
* isEnable: 是 否 启 用 ，1 为 启用 ，0 为 禁用 。 


完整 role 实体 类 内 容 如 代码 清单 14-4 所 示 。 


代码 清单 14-4 ”博客 后 台 项 目 -role 实体 内 容 


GEntity 
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Table (name = "role") 
GData 
GAllArgsConstructor 


GNoArgsConstructor 


public class Role implements Serializable ( 
private static final long serialVersionUID = 3392729947020278189L; 


Gerd 


GGeneratedValue (strategy = GenerationType.IDENTITY) 


private Long roleId; 
private String roleName; 
private Integer isEnable; 


GTransient 


private Integer isHave; 


public Role(Long roleId,String roleName, Integer isEnable) ( 


this.roleId = roleId; 
this.roleName - roleName; 
this.isEnable - isEnable; 


147 € 功 


与 第 13 章 一 样 ， 首 先 来 看 应 用 程序 的 目录 结构 ， 如 


图 14-13 所 示 。 


其 中 ， 每 个 包 对 应 的 功能 如 下 。 


* config: 配置 ， 案例 中 用 于 配置 拦截 器 和 Spring 
Security 授权 及 认证 配置 。 

* constants: HE, 案例 中 常量 类 所 在 的 包 .。 

* controller: 控制 层 ,案例 中 控制 层 大 多 只 用 于 封装 
数据 和 页 面 跳 转 。 
entity: 实体 类 。 
init: 初始 化 ， 用 于 初始 化 一 些 应 用 中 的 数据 。 
interceptors: 拦截 器 ， 案 例 中 加 载 登录 用 户 信息 、 
头 部 信息 等 。 
repository: 数据 操作 层 ， 用 于 JPA 操作 数据 库 。 
service: 业务 层 , 案例 中 用 于 调用 数据 操作 层 和 一 
些 业 务 逻 辑 处 理 。 


14-13 博客 后 台 项 目 -应 用 程序 目录 结构 
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e dimer 定时 器 ， 案 例 中 用 于 通过 邮件 发 送 每 日 博客 数据 统计 。 
o ui: 工具 ， 案例 中 只 有 一 个 计算 日 期 的 工具 类 。 


接 下 来 介绍 两 个 典型 的 功能 : 首页 和 文章 管理 。 


14.71 首页 


在 首页 主要 进行 一 些 数据 统计 ， 比 如 简单 汇总 统计 、 文 章 统计 、 标 签 统计 、 友 情 链 接 统计 和 
消息 统计 ， 这 些 都 是 利用 Repository 中 默认 的 count() 方 法 实现 的 。 另 外 ， 还 有 一 些 访 问 量 统计 ， 
比如 今日 访问 量 、 本 周 访问 量 、 本 月 访问 量 和 总 访问 量 。 在 JPA 中 ， 如 果 需 要 使 用 聚合 查询 ， 就 
需要 使 用 CriteriaBuilder 来 构建 聚合 查询 ， 如 代码 清单 14-5 所 示 。 


GOverride 
public Integer sumWebsiteAccess (Date date, Integer days) ( 


CriteriaBuilder criteriaBuilder - entityManager.getCriteriaBuilder(); 


CriteriaQuery«Integer^» query = criteriaBuilder.createQuery 


(Integer.class); 
Root«WebsiteAccess» root = query.from(WebsiteAccess.class); 


query.select (criteriaBuilder.sum(root.get ("accessCount"))); 


if (days -- null && date !- null) ( 


Predicate predicate = criteriaBuilder.equal(root.get("accessDate"), 


date); 
query.where (predicate); 
) else if (date !- null) ( 
Predicate predicate = criteriaBuilder.between(root.get 
("accessDate"), DateUtils.getDateBefore(date, days), date); 


query.where (predicate); 
5 
Integer result - 
if (result -- null) ( 


entityManager.createQuery (query).getSingleResult(); 


result = 0; 


} 
return result; 


) 


方法 查询 的 SQL 如 代码 清单 14-6 所 示 。 


代码 清单 14-6 ”博客 后 台 项 目 -聚合 函数 SQL 


select sum(websiteacc0 .access count) as col 0 0 from website access 


websiteacc0 where websiteaccO0 .access date-? 
select sum(websiteaccO0 .access count) as col 0 0 from website access 


websiteaccO0 where websiteaccO0 .access date between ? and ? 
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select sum(websiteacc0 .access count) as col 0 0 from website access 
websiteacc0 where websiteaccO0 .access date between ? and ? 

select sum(websiteaccO .access count) as col 0 0 from website access 
websiteaccO 


另外 , 首页 还 包含 一 个 访问 图 标 统计 图 , 就 是 查询 最 后 10 天 的 访问 记录 表 , 不 过 在 使 用 charts 
展示 时 需要 将 数量 和 日 期 分 别 从 集合 中 提取 出 来 。 这 里 使 用 Lambda 表达 式 提 取 对 应 属性 ， 如 代码 
清单 14-7 所 示 。 


代码 清单 14-7 ”博客 后 台 项 目 -数据 图 表 数 据 查询 


List<WebsiteAccess> websiteAccessList = 
websiteAccessService.findChartsWebsiteAccess(); 

List«Integer» websiteAccessCountList = 
websiteAccessList.stream().map(WebsiteAccess::getAccessCount). 

collect (Collectors.toList()); 

List«Date» websiteAccessDateList = 
websiteAccessList.stream().map(WebsiteAccess::getAccessDate). 

collect (Collectors.toList()); 


完整 首页 加 载 数据 查看 源 代码 即 可 ， 很 多 内 容 之 前 已 经 讲 过 了 。 


14.7.2 ”文章 管理 


在 博客 后 台 系 统 中 ， 很 多 列表 的 实现 都 很 相近 ， 这 里 以 文章 列表 为 例 进行 介绍 。 
1. 列表 查询 
文章 列表 查询 其 实 就 是 一 个 带 有 条 件 和 分 页 的 复杂 查询 ， 这 里 再 对 复杂 查询 介绍 一 次 。 使 用 


Specification 对 象 构建 查询 条 件 ， 这 里 设置 文章 ID 字段 为 精确 查询 ， 文 章 名 称 和 作者 名 称 都 是 使 
用 右 模 糊 查询 。 构 建 查询 条 件 的 方法 如 代码 清单 14-8 所 示 。 


代码 清单 14-8 博客 后 台 项 目 -文章 管理 构建 查询 条 件 内 容 


private Specification<RArticle> getWhereClause(Long articleId, String 
articleName, String articleAuthors) ( 
return new Specification«Article»() ( 
GOverride 
public Predicate toPredicate (Root«Article» root, CriteriaQuery«?» 
query, CriteriaBuilder cb) ( 
List«Predicate» predicate = new ArrayList«»(); 
if (articleId !- null) ( 
predicate.add( 
cb.or(cb.equal(root.get("articleId"), articleId)) 
); 
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b 
if (!StringUtils.isEmpty(articleName)) { 


predicate.add( 
cb.or(cb.like(root.get("articleName"), articleName 
nx tu ai D 
) 7 
} 
if (!StringUtils.isEmpty(articleAuthors)) ( 


predicate.add( 
cb.or(cb.like(root.get("articleAuthors"), 
articleAuthors + "$")) 
); 
H 
Predicate[] pre = new Predicate[predicate.size()]; 
return query.where (predicate.toArray (pre)).getRestriction(); 


Service 层 调用 如 代码 清单 14-9 所 示 。 


代码 清单 14-9 博客 后 台 项 目 -文章 管理 Service 层 内 容 


GOverride 
public Page«Article» findAllBySearch(Pages pages, Long articleId, String 
articleName, String articleAuthors) ( 
Pageable pageable - PageRequest.of (pages.getPage(), pages.getPageSize(), 
Sort.Direction.DESC, "articleId"); 
return articleRepository.findAll(this.getWhereClause (articleId, 
articleName, articleAuthors), pageable); 
1 


Controller 层 进行 一 些 数据 的 封装 ， 比 如 查询 数据 的 返回 、 分 页 参数 的 返回 、 列 表 返 回 等 。 完 
整 内 容 如 代码 清单 14-10 所 示 。 


代码 清单 14-10 ”博客 后 台 项 目 -文章 管理 Controller 内 容 


GGetMapping ("/list") 
public String article (Integer pageNumber, Long articleId, String articleName, 
String articleAuthors, Model model) ( 
Pages pages = Pages.defaultPages (pageNumber) ; 
Page«Article» articlePage = articleService.findAllBySearch (pages, 
articleId, articleName, articleAuthors); 
model.addAttribute("articleList", articlePage.getContent()); 
model.addAttribute ("totalCount", articlePage.getTotalElements ()); 
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model.addAttribute ("pageNumber", pages.getPageNumber()); 
model.addAttribute("articleName", articleName); 
model.addAttribute("articleAuthors", articleAuthors); 
model.addAttribute("articleId", articleId); 
model.addAttribute ("menuFlag", Constants.ARTICLE MENU FLAG); 


return "article/index"; 


) 


2. 预览 功能 
预览 功能 是 在 创建 文章 或 者 修改 文章 后 使 用 的 ， 在 博客 后 台 系统 中 直接 查询 文章 在 博客 内 的 


具体 展示 效果 ， 其 实 就 是 在 JavaScript 中 加 入 一 个 跳 转 方法 ， 如 代码 清单 14-11 所 示 。 


代码 清单 14-11 博客 后 台 项 目 -文章 管理 预览 


// 预 览 

function view(articleId)( 
window.open("https://localhost:10000/"*articleId," blank"); 

} 


3. 启用 和 禁用 

启用 和 禁用 其 实 就 是 修改 当前 文章 的 isEnable 属性 , 将 它 的 值 改 为 1， 在 前 台 发 起 Ajax WR, 
发 送 文章 ID 和 需要 修改 属性 的 值 。 内 容 很 简单 ， 这 里 就 不 介绍 了 。 

4. 删除 文章 

删除 文章 就 是 从 前 台 将 文章 ID 传 入 后 台 ， 然 后 在 后 台 调 用 Repositrory 的 deleteById() 方 法 。 

5. 新 增 和 修改 

单 击 文章 列表 页 的 “修改 ”按钮 会 跳 转 到 文章 编辑 页 ， 同 时 带 出 对 应 文章 的 内 容 。 单 击 新 增 


文章 就 会 新 增 一 篇 新 的 文章 ， 跳 转 页 面 时 首先 判断 是 否 传 了 文章 ID， 如 果 传 了 ， 就 查询 文章 内 容 
返回 前 台 ; 如 果 没 传 ， 就 返回 一 个 文章 ID 为 0 的 空 对 象 。 跳 转 方法 如 代码 清单 14-12 所 示 。 


代码 清单 14-12 博客 后 台 项 目 -文章 管理 新 增 或 修改 页 面 跳 转 方法 


@GetMapping("/saveOrUpdatePage") 
public String saveOrUpdateArticlePage (Model model, Long articleId) { 
Article article - new Article(); 
if (articleId !- null) ( 
article = articleService.findArticleByArticleId (articleId); 
y else í 
article.setArticleId (0L); 
} 
model.addAttribute("article", article); 
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model.addAttribute ("menuFlag", Constants.ARTICLE MENU FLAG); 
return "article/edit"; 


在 文章 编辑 页 中 设置 了 预览 文章 效果 ， 不 过 这 里 只 支持 Markdown 格式 预览 ， 使 用 的 是 
showdownjs。 不 过 有 一 个 缺点 ， 表 格 展示 不 出 来 ， 如 果 读 者 发 现 有 更 好 的 方式 ， 那 么 可 以 自行 修 
改 。 表 单 校 验 使 用 的 是 jquery.validatejs， 提 供 了 一 些 非 空 校 验 等 。 

前 台 保 存 方法 首先 触发 表单 校 验 ， 然 后 调用 Ajax 发 起 请 求 。 保 存 按钮 触发 方法 如 代码 清单 
14-13 所 示 。 


青 单 14-13 ”博客 后 台 项 目 -文章 管理 保存 或 修改 文章 前 台 内 容 


b] 


function saveArticle()(í 
if(!$('farticle form').valid())( 
return false; 


var url = getRootPath dc() + "article/saveOrUpdate"; 
var articleName = $('farticleName').val(); 

var articleAuthors = $('farticleAuthors').val(); 

var tagsStr = $('ftagsStr').val(); 

var isTop = $('input[name-"isTop"]:checked').val(); 

var articleContent = $('farticleContent').val(); 

var articleReadingTime = $('farticleReadingTime').val(); 
var isEnable = $('fisEnable').val(); 

var articleInputUser - $('farticleInputUser').val(); 


if(articleId -- O)( 
articleId = null; 
5 
$.ajax(t 
type : "POST", 
o UA ai YA 
dataType : "tezt", 
contentType: "application/json;charset-UTF-8", 
data : JSON.stringify(( 
"articleId":articleId, 
"articleName": articleName, 
"articleAuthors": articleAuthors, 
"tagsStr": tagsStr, 
"3sTop": isTop, 
"articleContent":articleContent, 
"articleReadingTime":articleReadingTime, 
"isEnable":isEnable, 
"articleInputUser":articleInputUser 
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n, 

success: function() { 
alert (" 提 交 成 功 ! ") 7 

) 

error:function()( 
alert ("error"); 


n; 


保存 和 新 增 后 台 方 法 会 根据 标签 字符 串 内 的 逗号 进行 分 割 ， 每 一 个 逗号 前 代表 一 个 不 同 的 标 
签名 称 ， 然 后 根据 标签 名 称 进 行 查询 ， 如果 不 存在 当前 标签 名 称 ， 就 新 增 一 个 ， 并 且 将 标签 和 文章 
进行 关联 ， 完 整 内 容 如 代码 清单 14-14 所 示 。 


代码 清单 14-14 ”博客 后 台 项 目 -文章 管理 保存 或 修改 文章 Service 层 内 容 


GOverride 
GTransactional(rollbackFor = Throwable.class) 
public void saveOrUpdateArticle(Article article) ( 
String tagsStr - article.getTagsStr(); 
List«Tag» tagList = new ArrayList«»(); 
if (StringUtils.isNotBlank(tagsStr)) ( 
String[] tagNames - tagsStr.split(","); 
for (String tagName : tagNames) ( 
Tag tag = tagService.findTagByTagName (tagName) ; 
if (tag == null) ( 
tag - new Tag(tagName); 
tag.setTagInputDate (new Date()); 
} 
tag = tagService.saveTag (tag); 
tagList.add(tag); 


Ü 

article.setTagList(tagList); 

if (article.getArticleId() -- null) ( 

article.setIsEnable (Constants.NO); 
article.setArticleInputDate (new Date()); 
article.setArticleInputUser (1L); 
article.setArticleReadingTime (0); 

} 

articleRepository.save (article); 


有 关 文 章 的 操作 大 致 就 这 些 ， 读 者 可 以 查看 配套 源 代 码 学 习 。 
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14.8 辅助 功能 


接 下 来 介绍 博客 后 台 系 统 的 辅助 功能 ， 如 拦截 器 、 定 时 器 、 认 证 和 授权 、 工 具 类 。 


1481 ”拦截 器 


在 拦截 器 中 首先 判断 是 否 返 回 页 面 ， 如 果 返 回 页 面 ， 就 泻 染 一 些 基 本 数据 ， 如 菜单 集合 、 头 
部 信息 、 底 部 信息 等 。 完 整 内 容 如 代码 清单 14-15 所 示 。 


| 


GComponent 
public class RequestInterceptor extends HandlerInterceptorAdapter ( 
GAutowired 
private AuthenticationService authenticationService; 
GAutowired 
private WebsiteConfigService websiteConfigService; 
GAutowired 
private TagService tagService; 
GAutowired 
private ArticleService articleService; 
GAutowired 
private MessageService messageService; 
GAutowired 


private UserService userService; 


GOverride 
public void postHandle (HttpServletRequest request, HttpServletResponse 
response, Object handler, ModelAndView modelAndView) throws Exception ( 
if (modelAndView !- null) ( 
ModelMap modelMap = modelAndView.getModelMap(); 
Date date = new Date(); 
// 加 载 数据 
Authentication auth = authenticationService.getAuthentication(); 
if (auth != null) ( 
String username = auth.getName(); 
modelMap.addAttribute ("username", username); 
User user - userService.findByUsername (username); 
if(user !- null)( 


// 赋 值 用 户 所 拥有 的 菜单 集合 ， 动 态 泻 染 菜单 


第 14 章 Spring Boot 实战 之 博客 后 台 系统 | 


369 


modelMap.addAttribute ("userRoleList", Constants. 
getUserRoleList (user.getRoleList())); 
} 

Integer messageCount = messageService.countByIsRead 
(Constants.NO); 

modelMap.addAttribute("messageCount", messageCount); 

Integer tagCount = tagService.countByTagInputDate (date); 

modelMap.addAttribute("tagCount", tagCount); 

Integer articleCount = articleService.countByArticleInputDate 
(date); 

modelMap.addAttribute("articleCount", articleCount); 

modelMap.addAttribute("sumCount", articleCount + tagCount 4 
messageCount); 

List«Message» messageList = messageService.findAllByIsRead 
(Constants.NO); 

modelMap.addAttribute("mainbarMessageList", messageList); 

modelMap.addAttribute("mainbarMessageListCount", messageList. 
size()); 

modelMap.addAttribute("websiteConfig", websiteConfigService. 
findWebsiteConfig()); 


14.8.2 ”定时 器 


定时 器 主要 用 于 查询 一 些 博客 的 数据 ， 然 后 将 数据 封装 起 来 ， 以 邮件 的 形式 发 送 。 完 整 内 容 


如 代码 清单 14-16 所 示 。 


清单 14-16 ”博客 后 台 项 目 -定时 器 内 


m 


GComponent 
public class WebSiteTimer ( 
private final Logger logger - LoggerFactory.getLogger (this.getClass() 
GAutowired 
private WebsiteConfigService websiteConfigService; 
GAutowired 
private JavaMailSender javaMailSender; 
GAutowired 
private WebsiteAccessService websiteAccessService; 
GAutowired 


); 
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private MessageService messageService; 
GScheduled(cron = "0 0 0 1/1 * ?") 
private void sendDailyData() ( 
String subject = "博客 每 日 数据 "; 
String text = this.initData(); 
WebsiteConfig websiteConfig = websiteConfigService. 
findWebsiteConfig(); 
SimpleMailMessage simpleMailMessage - new SimpleMailMessage(); 
simpleMailMessage.setFrom(websiteConfig.getEmailUsername()); 
simpleMailMessage.setTo(websiteConfig.getEmailUsername()); 
simpleMailMessage.setSubject (subject); 
simpleMailMessage.setText (text); 
tr 
javaMailSender.send(simpleMailMessage); 
logger.info ("发 送 博客 每 日 数据 成 功 ! n) ; 
} catch (Exception e) { 


logger.error ("发 送 博 客 每 日 数据 异常 ! n, e); 


private String initData(){ 

StringBuffer stringBuffer - new StringBuffer(); 

SimpleDateFormat sdf-new SimpleDateFormat ("yyyy-MM-dd"); 

WebsiteAccess websiteAccess - websiteAccessService.getByAccessDateIs 
(new Date()); 

stringBuffer.append(" 日 期 是 ，") ; 

stringBuffer.append(sdf.format (websiteAccess.getAccessDate())); 

stringBuffer.append (" 访 问 量 为 : ") 

stringBuffer.append (websiteAccess.getAccessCount ()); 

stringBuffer.append (" 未 读 消 息 有 : "); 

int count = messageService.countByIsRead(Constants.YES); 

stringBuffer.append (count); 

stringBuffer.append ("A"); 

return stringBuffer.toString(); 


14.8.3 ”认证 和 授权 


由 于 这 是 一 个 后 台 系统 ， 因 此 不 允许 没有 权限 的 人 随意 登录 ， 并 且 在 博客 后 台 系统 中 默认 设 
置 了 4 个 角色 ， 分 别 说 明 如 下 。 


© USER: 拥有 首页 、 文 章 管理 、 标 签 管 理 的 权限 。 
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* ADMIN: 拥有 首页 、 文 章 管理 、 标 签 管理 、 友 情 链接 管理 、 用 户 管理 、 消 息 管理 的 权限 。 
© SYSADMIN: 拥有 首页 、 系 统管 理 的 权限 。 
* SUPERADMIN: 拥有 全 部 权限 。 


SecurityConfig 配置 如 代码 清单 14-17 所 示 。 


代码 清单 14-17 博客 后 台 项 目 -安全 配置 


GEnableWebSecurity 

public class SecurityConfig extends WebSecurityConfigurerAdapter ( 
GAutowired 
private MyUserDetailsService myUserDetailsService; 


/** 
* 权限 设 定 
* 分 为 4 种 角色 : 
* USER (拥有 首页 、 文 章 管理 、 标 签 管理 权限 ) 
* RDMIN (拥有 首页 、 文 章 管理 、 标 签 管理 、 友 情 链 接管 理 、 用 户 管理 、 消 息 管理 权限 ) 
* SYSADMIN (拥有 首页 、 系 统管 理 权限 ) 
* SUPERADMIN (拥有 全 部 权限 ) 
* 后 期 可 以 修改 为 动态 获取 
y 
GOverride 
protected void configure(HttpSecurity httpSecurity) throws Exception { 
httpSecurity 
.csrf().disable()//XH] scrf 
.authorizeRequests() 
.antMatchers ("/static/**") .permitAll () 
.antMatchers ("/") .hasAnyRole ("USER" , "ADMIN", "SYSTEMADMIN", 
"SUPERADMIN") 
.antMatchers ("/index/**") .hasAnyRole ("USER", "ADMIN", 
"SYSTEMADMIN", "SUPERADMIN") 
.antMatchers ("/article/**") .hasAnyRole ("USER", "ADMIN", 


"SUPERADMIN") 
.antMatchers ("/tag/**") .hasAnyRole ("USER", "ADMIN", 
"SUPERADMIN") 
.antMatchers ("/link/**") .hasAnyRole ("ADMIN", "SUPERADMIN") 
.antMatchers ("/user/**") .hasAnyRole ("ADMIN", "SUPERADMIN") 
.antMatchers ("/message/**") .hasAnyRole ("ADMIN" , "SUPERADMIN") 
.antMatchers ("/system/**") .hasAnyRole ("SYSTEMADMIN", 
"SUPERADMIN") 


.and() 

-formLogin().loginPage("/login").failureUrl("/login error"). 
successForwardUrl ("/") 

.and() 
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-logout ().logoutUrl ("/logout").logoutSuccessUrl ("/login"). 
deleteCookies ("JSESSIONID") 

-and() 

.exceptionHandling () .accessDeniedPage ("/login"); 


GBean 
public static NoOpPasswordEncoder passwordEncoder() { 
return (NoOpPasswordEncoder) NoOpPasswordEncoder.getInstance(); 


// 根 据 用 户 名 和 密码 实现 登录 
GAutowired 
public void configureGlobal (AuthenticationManagerBuilder 


authenticationManagerBuilder) throws Exception ( 


authenticationManagerBuilder.userDetailsService (myUserDetailsService); 


i 


创建 一 个 MyUserDetailsService 配置 用 户 的 认证 ， 如 代码 清单 14-18 所 示 。 


代码 清单 14-18 博客 后 台 项 目 -安全 配置 内 容 2 


@Service 

public class MyUserDetailsService implements UserDetailsService { 
@Autowired 
private UserRepository userRepository; 


GOverride 
public UserDetails loadUserByUsername (String username) throws 
UsernameNotFoundException ( 
User user - userRepository.findByUsername (username); 
if (user -- null)( 
throw new UsernameNotFoundException (" 用 户 不 存在 ! "); 
Jelse if(user != null && Constants.NO.equals (user.getIsEnable()))( 
throw new UsernameNotFoundException ("用 户 未 启用 ， 请 联系 管理 员 ! ") ; 
j 
List«SimpleGrantedAuthority» simpleGrantedAuthorities - new 
ArrayList«»(); 
for (Role role : user.getRoleList()) ( 
simpleGrantedAuthorities.add(new SimpleGrantedAuthority 
(role.getRoleName())); 
b 
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return new org.springframework.security.core.userdetails.User 
(user.getUsername(), user.getPassword(), simpleGrantedAuthorities); 
} 


14.8.4 工具 类 


案例 中 的 工具 类 只 做 了 传 入 日 期 和 天 数 来 查询 几 天 前 的 日 期 ， 如 代码 清单 14-19 所 示 。 


代码 清单 14-19 博客 后 台 项 目 -计算 日 期 工具 类 内 容 


public class DateUtils ( 
public static Date getDateBefore(Date date,int day)( 
Calendar calendar - Calendar.getInstance(); 
calendar.setTime (date); 
calendar.set(Calendar.DATE, calendar.get(Calendar.DATE) - day ); 
return calendar.getTime(); 


14.8.5 “初始 化 方法 


初始 化 方法 中 ,插入 角色 信息 以 及 默认 插入 一 个 用 户 名 为 admin、 密 码 为 123 的 用 户 ， 如 代码 
清单 14-20 所 示 。 


代码 清单 14-20 博客 后 台 项 目 -初始 化 数据 内 容 


GComponent 
public class InitData ( 
GAutowired 
private RoleRepository roleRepository; 
GAutowired 
private UserService userService; 
GAutowired 
private WebsiteConfigService websiteConfigService; 


GPostConstruct 

private void initRoleData() ( 
Role rolel - new Role(1L, "ROLE USER", 1); 
Role role2 - new Role(2L, "ROLE ADMIN", 1); 
Role role3 - new Role(3L, "ROLE SUPERADMIN", 1); 
Role role4 = new Role(4L, "ROLE SYSTEMADMIN", 1); 
List«Role» roleList = new ArrayList<>(); 
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roleList.add(rolel); 
roleList.add(role2); 
roleList.add(role3); 
roleList.add(role4); 
roleRepository.saveAll(roleList); 
User user = userService.findUserByUserId(1L); 
if (user -- null) ( 
userService.saveOrUpdateUser(new User(1L, "admin", "123", 
"admin8springboot.cn", 1, roleList)); 
) 
WebsiteConfig websiteConfig = websiteConfigService. 
findWebsiteConfig(); 
if (websiteConfig -- null) ( 
websiteConfigService.saveWebsiteConfig (new WebsiteConfig (1L, 
"SpringBoot 博客 "， "dalaoyang", 7L, "XL ICP % 17014944 5-1", "Dalaoyang.cn", 
"dalaoyangGaliyun.com")); 


) 


14.9 小 结 


本 章 对 博客 后 台 系 统 的 制作 进行 了 介绍 ， 在 实际 项 目 中 大 多 如 此 ， 和 希望 大 家 多 多 练习 ， 熟 能 
生 巧 ， 将 所 学 的 知识 运用 到 实践 中 。 
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13 位 专家 力荐 ! 


MANAN = . 本 书 理论 与 工程 实践 相 结 合 ， 全 面 阐述 Spring 5 的 新 特性 
EN J- = 从 Spring 实战 到 源码 分 析 ， 再 到 原理 剖析 ， 以 及 Spring 与 各 种 主流 中 间 件 
= 及 框架 结合 的 落地 实践 ， 可 以 让 读者 深入 理解 Spring 的 实现 原理 和 底层 架 
Spring 5 构 ， 使 用 Spring 的 强大 功能 至 上 而 下 地 构建 复杂 的 Spring 应 用 程序 
企业 级 开发 实战 


€— uem 


微服 务 组 件 染 构 案例 实战 指南 


= 以 Spring Cloud 微 服务 架构 为 主线 
* 以 案例 讲述 Spring Cloud 的 常用 组 件 
* 轻松 掌握 基于 Spring Cloud 微 服务 架构 的 开发 技术 


掌握 Spring 框 保 共 础 ， 快 速 形成 Spring 框 架 全 局 观 


Spring 快速 入 门 本 书 介绍 Spring 框架 各 个 模块 的 使 用 ， 并 集成 Spring Boot, Spring MVC, MyBatis 
mis iiie 技术 实现 一 个 项 目 案例 ， 让 读者 轻松 快速 上 手 Spring 框架 。 


通过 JavaSeript 实 例 掌 握 Web 前 端 开 发 技术 


。 涵 盖 目 前 流行 的 特效 、 流 行 的 JS 技术、 流行 的 Vue 与 React 框 架 JavaScripttVue gr 
9 包括 众多 JavaScript 应 用 场景 ， 直 接 感受 实际 开发 出 来 的 页 面 效 果 4] 7] 
* 围绕 实例 进行 讲解 ， 每 一 节 都 可 以 让 读者 掌握 一 种 实用 技术 


掌握 SSM 框 架 技术 ， 提 升 SSM 整 合 开发 应 用 系统 的 能 力 


spring+ Spring MVC 本 书 系统 讲解 SSM 框 架 的 基础 知识 和 整合 技术 ， 并 通过 代码 和 案例 
+MyBatis 从 零 开始 学 将 理论 知识 升华 ， 使 读者 学 习 完 本 书 以 后 就 能 比较 全 面 地 掌握 SSM 


框架 ， 并 有 具备 使 用 SSM 框 架 开发 应 用 系统 的 能 力 。 


深入 浅 出 Spring 5 核心 技术 
从 0 到 1 轻松 构建 企业 级 项 目 
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掌握 主流 前 后 端 技术 ， 染 构 和 开发 一 个 完整 系统 案例 
, 本 书 使 用 当前 主流 前 后 端 技术 ， 从 项 目 实践 出 发 带领 污 者 从 零 
和 开始， 一步 一 步 地 开发 出 一 款 界面 优 秦 、 架 构 优良 、 代 码 简洁 、 
注释 完善 、 基 础 功能 相对 完整 的 权限 管理 系统 。 读 者 可 以 以 此 为 


Sprig epp née 范例 从 中 学 习 和 汲取 技术 知识 ， 也 可 以 基于 此 系统 开发 和 实现 具 
FE 体 的 生产 项 目 。 

掌握 Spring Boot 全 栈 开 发 流程 ， 独 立 实现 大 型 SPA 应 用 

-讲述 Spring、Spring MVC, MyBatis, Spring Boot 和 Vue 全 栈 开 发 技术 Q 


“所 有 的 知识 点 都 配 有 实例 ， 让 读者 理解 理论 的 同时 也 掌握 开发 技能 


- 通过 微 人 事项 目 实战 ， 提 高 你 的 全 栈 开 发 水 平 Springnota 
全 栈 开发 实战 
| 
| uu. 使 用 Spring 5+Spring MVC 5«MyBatis 3.4.6 整 合 开发 
Bog MUT Myr ~ 从 原理 到 实践 ， 详 解 Web 轻 量 级 框架 SSM 整 合 开 发 技术 
| 快速 开发 与 项 目 实战 - 融合 Redis 缓 存 、 消 息 中 间 件 MQ 等 热门 技术 的 高 并 发 点 赞 项 目 实 践 


以 项 目 开 发 为 主线 
涵盖 Spring Boot 整 合 众 多 热门 技术 的 开发 案例 


一 步 - 步 学 


CSDN 博 客 专家 专业 奉献 Spring Boot 


diese 


